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4.0 uses logical 
units for separate 
compilation 


Pascal 4.0 lets you 
break up the code gang into 
“units,” or chunks.” These 
logical modules can be 
worked with swiftly and 
separately—so that an 
error in one module is 
seeable and fixable, and 
you re not sent through all 
your code to find one error. 
Compiling and linking these 
separate units happens in a 








flash because your compil- 
ing horsepower is better 
than 27,000 lines a min- 
ute.* And 4.0 also includes 
an automatic project Make. 


4.0’s cursor 
automatically lands 
on any trouble spot 


4.0’s interactive error 
detection and location 
means that the cursor 
automatically lands where 
the error is. While you're 
compiling or running a 
program, you get an error 
message at the top of your 
screen and the cursor flags 


the error’s location for you. 


4.0 gives you an 
integrated program- 
ming environment 


4.0’s integrated environ- 
ment includes pull-down 


menus and a built-in editor. 


Your program output Is 


Please check box(es) Sugg. Retail Upgrade Pricet Serial No. 
QO Turbo Pascal 4.0 Compiler $ 99.95 $ 39.95 
O Turbo Pascal Tutor 69.95 19.95 
O Turbo Pascal Database Toolbox 99.95 29.95 
O Turbo Pascal Graphix Toolbox 99.95 29.95 
O Turbo Pascal Editor Toolbox 99.95 29.95 
O Turbo Pascal Numerical Methods Toolbox 99.95 29.95 
O Turbo Pascal Gameworks 99.95 29.95 

Total product amount $ 

CA and MA residents add sales tax $ 

In US please add $5 shipping and handling for 

each product ordered $ 

Outside US please add $10 shipping and 

handling for each product ordered $ 

Total amount enclosed $ 
Please specify diskette size: O 5%” O 3%” 


Payment: 
Credit card expiration date: _____—_—_/ 





O VISA O MC O Check O Bank Draft 


Cad* |_| [| | | | | | | [| | | [| | | [| | | J 


tTo qualify for the upgrade price you must give the serial number of the equivalent product you are upgrading. 
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automatically saved and 
shown in the output 
window. You can Scroll, 
Pan, or Page through all 
your output and know 
where everything is all the 
time. Given 4.0’s integra- 
tion, you can edit, compile, 
find and correct errors—all 
from inside the integrated 
development environment. 


You ll never lose your 
mind, because 4.0 
never loses your place 


Whenever you re-load 4.0, 
it remembers what you and 
it were doing before you 
left. It puts you right back 
in the editor with the same 
file and in the same place 
as you were working last. 


*Run on an 8 MHz IBM AT. 


**lf within 60 days of purchase this product does not perform in 
accordance with our claims, call our customer service department, 
and we will arrange a refund. 


All Borland products are trademarks or registered trademarks of 
Borland International, Inc. Other brand and product names are 

trademarks or registered trademarks of their respective holders. 
Copyright © 1987 Borland International, Inc. 
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Program in the 
fast lane with 
Borland’s new 
Turbo Pascal 4.0. 





The fast lane is fas 


ur new Turbo 

Pascal® 4.0 is so 

fast, it’s almost 
reckless. How fast? 
Better than 27,000 lines 
of code per minute. That's 
much faster than 3.0 or 
any other Pascal compiler 
and the reason why you 
need 4.0 today. 


Pascal. The fastest 
and the best. 


If you re just now 
learning a computer lan- 
suage, learn Pascal. If 
you re already program- 
ming in Pascal, you're 
programming with a 
winner because Pascal is 
the worldwide language 
of choice. Pascal is the 
most popular language 
in university computer 
science classes and with 
computer enthusiasts 


structure. It’s powerful, 
coherent, easy to learn 
and use—and with Turbo 
Pascal 4.0—faster than 
ever before. 


Turbo Pascal: 
Technical excellence 


Commitment to tech- 
nical excellence and 


COMPILE 
INITHE 


FASTILANE 





Superiority also means 


commitment to detail, 
however painstaking, and 


decessor, Turbo Pascal 
3.0 is the worldwide 
standard, and with Turbo 
Pascal 4.0, we've bet- 
tered that standard. 4.0 is 
clearly the world’s fastest 
development tool for the 
IBM® PS/2 series, PC’s 
and compatibles—and the 
world’s favorite Pascal 
compiler. 


4.0 breaks the 
code barrier 

No more swapping 
code in and out to beat 
the 64K code barrier. 
Designed for large pro- 
crams, Turbo Pascal 4.0 
lets you use all 640K 
memory in your compu- 
ter. You paid for all that 
memory, now you can 
use it freely. 


For the IBM PS/2 and the IBM and 


who appreciate Pascal’s that takes time. 4.0’s pre- 


modern ——s 


Compaq families of personal computers 
and all 100% compatibles. 





Senna turn anes STE are tern remeron 


. I want to upgrade to Turbo Pascal 4.0 


YE S @ and the 4.0 Toolboxes 


Registered owners have been notified by mail. If you are a registered Turbo Pascal user and 
have not been notified of Version 4.0 by mail, please call us at (800) 543-7543. To upgrade if 
you have not registered your product, just send the original registration form from your manual 
and payment with this completed coupon to: 





Pascal 4.0 Upgrade Dept. Name 

Borland International 

4585 Scotts Valley Drive —- Ship Address 

Scotts Valley, CA 95066 City State 


Zip Telephone ( ) 


This offer fs limited to one upgrade per valid registered product. It is good until June 30, 1988. Not good with any other offer from Borland. 


Outside U.S. make payments by bank draft payable in U.S. dollars drawn on a U.S. bank. CODs and purchase orders will not be accepted by Borland. DDJ 2/88 





Nows the time 
for a fast decision: 
Upgrade now to 40! 


Compatibility with = Interactive error 
Turbo Pascal 3.0 detection /location | 
We've created 4.0 to = Includes acommand line 
be highly compatible with version of the compiler 
version 3.0 and included a 4.0 also 
conversion program and = Saves output screen in a 
compatibility units to help window 
you convert all your 3.0 : tp — and 50 
l 
programs to 4.0. = Generates MAP files for 
; ; debugging 

/ eae of = Has graph units including 

orland’s new CGA, EGA, VGA, MCGA, 
Turbo Pascal 4.0 3270 PC, AT & T6300 & 

; Hercules support 

i Compiles 27,000 lines = Supports extended data 

per minute types (including word, long 
= Supports >64K programs integers 
= Uses units for separate = Does smart linking 

compilation = Comes with a free revised 
= Integrated development MicroCalc spreadsheet 


source code 
4.0 is all yours for only $99.95 


Sieve (25 iterations) 


environment 








Turbo Pascal 4.0 =—«*Turbo Pascal 3.0 
11682 bytes 





Size of Executable File 








9.3 seconds | 9.7 seconds 





Execution speed 











Sieve of Eratosthenes, run on an 8MHz IBM AT 


Since the source file above is too small to indicate a difference in compilation speed we compiled our GOMOKU program from Turbo Gameworks to give 
you a true sense of how much faster 4.0 really is! 


Compilation of GO.PAS (1006 lines) 


Turbo Pascal 4.0 Turbo Pascal 3.0 


Compilation speed 2.2 seconds 3.6 seconds 


Lines per minute | 7,436 


GO.PAS compiled on an 8 MHz IBM AT 60-Day Money-Back Guarantee** 
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For the dealer nearest 
you or to order call 


BORLAND 800) 543-7543. 


INTERNATIONAL 








CIRCLE NO. 101 ON READER SERVICE CARD 





Accent on C with 


TOOLS PLUS/5.0 


Enhance your Microsoft C programming environment with 
C TOOLS PLUS/5.0™—a new, quintessential library of C 
tions. C TOOLS PLUS/5.0 from Blaise Computing Inc. puts a prime 
quickly building professional applications using the full power of 
C Version 5.0 and QuickC. Now you can concentrate on program 
y by having full control over DOS, menus, interrupt service routines, 
-y resident programs, printer and keyboard control, and more! 


C TOOLS PLUS/5.0 prebuilt libraries are ready to use 
with either QuickC or the Microsoft C Version 5.0 com- 
mand line environment. Complete documented source 
code is included so that you can study and adapt it to your 
specific needs. Blaise Computing’s attention to detail, like 
the use of full function prototyping, cleanly organized 
header files, and a comprehensive, fully-indexed manual, 
makes C TOOLS PLUS/5.0 the choice for experienced 
developers as well as newcomers to C. 





























Continuous refinement of Blaise Computing’s library 
products has produced a collection of tools that are 
unsurpassed for reliability, functionality and ease of use. 
Built upon the widely acclaimed C TOOLS PLUS, 


C TOOLS PLUS/5.0 includes such highly-developed 


features as: 
: @ INTERVENTION CODE 
able. — Schedule C functions at specified times, inter- 
ders, cursor memory. vals or with a “hot key’ NEW! 
sr input, formatted output. — Take full advantage of DOS, even from memory 
printf” window-oriented output. NEW! resident programs. NEW! 
® INTERRUPT SERVICE ROUTINES @ FAST DIRECT VIDEO ACCESS 
— Capture DOS critical errors and keystrokes. — All monitors, even EGA 43-line mode. 
@ PRINTER CONTROL 


— Install hardware interrupt handlers. 
@ RESIDENT SOFTWARE SUPPORT — Access BIOS print functions. NEW! 
— Control the DOS PRINT utility. NEW! 


— Install, detect and remove memory resident 













programs. @ UTILITIES AND MACROS 
@ MENUS — Take advantage of DOS file structure. 
~ _.  —Horizontal and pulldown. — Manipulate data types, far & near pointers. NEW! 
| 4 NEW! — Access any memory areas with fast “peek” and 


— Lotus-style support. NEW! “poke” macros. NEW! 


C TOOLS PLUS/5.0 supports the Microsoft C Version 5.0 and QuickC 
ompilers, requires DOS 2.00 or later and is just $129.00. 


ASYNCH MANAGER™ Version 2.0 IMPROVED! 

C ASYNCH MANAGER is a library of functions designed to help you 
incorporate asynchronous communication capabilities into your 
application programs. Version 2.0 has been rewritten especially for 
Microsoft C Version 5.0 and Borland’s Turbo C. Simultaneous 
buffered input and output to both COM ports at speeds up to 
9600 baud, XON/XOFF protocol, modem con- 


products for both Pascal and C. Call today for your 4 UPS shipPme 

free information packet. 1 
Name: 

* Address: 


ESSE SSUES. 20S ar 
BLAISE COMPUTING INC. 


2560 Ninth Street, Suite 316 Berkeley, CA 94710 (415) 540-5441 
CIRCLE NO. 102 ON READER SERVICE CARD 


a VISA 


Le.--" 





trol and XMODEM file transfer are among Lee", prim 
the many features supported and is priced at T yes! Send me 
just $175.00. Enclosed 
‘ : é pleas 
Blaise computing Inc. hasafulllineofsupport 4% - A residen 


q City: a MACH: : 


AGER 
| reen control; paint screens; block 
ode data entry or field-by-field control with 


$275.00 “=~ 










instant screen access. For C or MS-Pascal. 


Turbo C TOOLS $129.00 


Windows; ISRs; intervention code; screen 


handling and EGA 43-line text mode support; 
direct screen access; DOS file handling and 


more. For Turbo C. 


Turbo POWER SCREEN 


COMING SOON! General screen manage- 





ment: paint screens; block mode dataentry = 
or field-by-field control with instant screen 


access. For Turbo Pascal. 


Turbo POWER TOOLS PLUS $129.00 


Screen and window management including 


EGA support: DOS memory control: ISRs; . . 


scheduled intervention code; and much more. 


Now supports Turbo Pascal 4.0! 


Turbo ASYNCH PLUS 


$129.00 


Interrupt driven support for the COM ports. — ; / : 
I/O buffers up to 64K: XON/XOFF; upto 


9600 baud: modem and XMODEM control. — 


Now supports Turbo Pascal 4.0! 


PASCAL TOOLS/TOOLS 2. $175.00 


Expanded string and screen handling; graph- 


ics routines; memory management; general 


program control; DOS file support and more. 
For MS-Pascal. 


ASYNCH MANAGER 


Full featured interrupt driven support for the 


$175.00 


COM ports. I/O buffers up to 64K; XON/ 


XOFF: up to 9600 baud; modem control and 
XMODEM. For MS-Pascal. 


KeyPlayer 


“Super-batch” program. Create batch files 


which can invoke programs and provide 


input to them; run any program unattended; 
create demonstration programs; analyze key- 


board usage. 
EXEC $95.00 


NEW VERSION! Program chaining execu- 


$49.95 


tive. Chain one program from another in dif- — : 


ferent languages; specify common data areas; 
less than 2K of overhead. 


RUNOFF 


$49.95 


Text formatter for all programmers; flexible 


printer control; user-defined variables; index 


generation; general macro facility. Crafted 
in Turbo Pascal. 


LIGHT TOOLS 
Windows: ISRs: EGA 43-line text mode; 
direct screen access; DOS file handling and 
more. For the Datalight C compiler. 


$99.95 


TO ORDER CALL TOLLFREE 


is a registered trademark of Borland Intern 
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About the Cover 

The collective Doctor would 
like to thank his friends in 
charge of the Insect Zoo at the 
San Francisco Zoo for their 
loan of the Scarab Beetle which 
appears so prominently on the 
cover and elsewhere in the 
magazine. After our art director 
had bagged a bunch of these 
beauties, we told him that what 
we really wanted to show was 
some fairly sophisticated ways 
to eliminate the pesky critters. 
His comments on the inap- 
propriateness of a nuked bug 
on the cover, and his thorough 
disgust at the entire concept, 
forced us settle for this issue’s 
(admittedly tasteful) cover. 


Next Issue 
DDJ’s March issue welcomes 
back the Mac column from its 
temporary space crunch hiatus 
and features some interesting 
examples of the object-oriented 
paradigm. 





Take a look at the specs on VISTA™, a good look. 
Notice the processing, programming, and video 
capabilities? Now think real hard about what you could 
do with the power of VISTA and a microcomputer. Incor- 
porate it with your system to create a digital pre-press 
proofing station for publishing. Design a graphics work- 
station which outputs both colorful hi-resolution slides 
and broadcast-quality animated images. Construct a 


CAD system which merges computer generated images 
with real-life backdrops for architecture, packaging or 


other industries. And, after you’ve brainstormed your 
way to new horizons of videographics possibilities, get 
your own VISTA and start working. 








Let’s Get Specific. 


We knew you couldn't resist seeing the 
facts, and frankly, our engineers 
wouldn't have it any other way. Here is 
an overview of VISTAS key features. 


FEATURES: 


¢ 4Mbytes of Video RAM on-board 

¢ Texas Instruments’ TMS 34010 GSP 

¢ Flexible, programmable resolutions 

¢« NTSC and PAL compatible 

¢ Four 8-bit channels for real-time 
capture 

¢ Fully integrated genlock 

¢ Processor memory expandable in 
2Mbyte increments to 12Mbytes 

¢ Four 2K x 8-bit CMOS static RAM 
LUTs 

¢ Display can be color-mapped, RGB, 
or a versatile combination of both 

¢ Interlaced and non-interlaced display 

¢ Binary and fractional programmable 
zoom Capability, creates horizontal 
and vertical magnify or minify 

¢ Smooth horizontal and vertical pro- 
grammable panning, includes wrap- 
around and split screen 

¢ Suggested Retail Price: $5995. 


In Italy, contact S/R/O Informatica at 39-2-301-0051. 





Introducing VISTA" Videographics. — 


ADDRESSABLE RESOLUTIONS: 


32 bits/pixel 16 bits/pixel 8 bits/pixel 
1024x1024 2048x1024 4096x1024 
512x2048 1024x2048 2048x2048 
256x4096 512x4096 1024x4096 
CAPTURE RESOLUTIONS:* 
NTSC PAL 
(RS-170A) . (CCIR-624) 
756x486 738x576 
604x486 590x576 
504x486 492x576 
432x486 422x576 


*Resolutions are programmable; these are nominal ones 


for interlaced NTSC and PAL compatible. 
DISPLAY RESOLUTIONS:* 


NTSC 
(RS-170A) 
1512x486 
1008x486 
756x486 
604x486 
504x486 


*Resolutions are programmable; these are nominal ones. 


PAL 


(CCIR-624) 
1476x576 
984x576 
738x576 
590x576 
492x576 


Interlaced 


1024x768 


(60 Hz) 


768x768 
(80 Hz) 


COMPUTER REQUIREMENTS: 


Host Type: IBM PC AT and 100% Compati- 
bles, Compaq 386, 
Apollo DN 3000-single-siot board 
Data Bus: 16-bit or 8-bit (self-configuring) 
Bus Clock: 6MHz to 12MHz 
Power 
Consumption: 15 Watts 


‘TRUEVISION’ 


CIRCLE NO. 103 ON READER SERVICE CARD 


IBM is a registered trademark of International Business Machines Corp. International Inquiries: contact Techexport at 617/890-6507 (USA), or London at 44-1-991-0121. 
uggested retail price is US domestic price. 


Non- 
interlaced 


768x576 
(50 Hz) 


756x486 
(60 Hz) 










It’s So Flexible, 
We’ve Added Support. 


With its Texas Instruments TMS 34010 
graphics processor, large quantity of 
video memory, and proprietary video 
cross-point, VISTA can be programmed 
for an array of powerful market-specific 
videographic applications. To help you 
maximize VISTA‘ potential, Truevision 
offers a range of C-language program- 
ming tools for developers. And when 
your system is market-ready, we'll sup- 
port your marketing efforts with our 
TRUEVISION SOFTWARE CATALOG, 
TRUEVISION NEWS, and THE PULSE. 


We’re For Higher 


Resolution...Power... Flexibility... 
Quality. Join the many key manufac- 
turers and developers already working 
with the state of the videographics art, 
VISTA. Call us at 800/858-TRUE for 
more information on the VISTA 
Developer's Program. We're ready to 
take your application today. 


"TRUEVISION’ 


7351 Shadeland Station, Suite 100 
Indianapolis, IN 46256 
800/858-TRUE 
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EDITORIAL 


The Doctor and Copy Rites 


very so often a letter arrives at 

the DDJ offices that demon- 
strates a reader's concern over the 
issue of software copyright. Given 
that we often publish both articles 
and source code listings that in- 
clude an author's “All Rights Re- 
served” copyright notice, the ques- 
tion has been raised as to what 
rights (if any) the reader has. A strict 
reading of copyright law would lead 
you, after all, to the conclusion that 
even photocopying a section of a 
magazine you'd bought would be 
copyright infringement. Given the cur- 
rent litigious climate of the software 
industry, it’s probably a good idea 
that we at DDJ at least give you a 
statement of our policies and atti- 
tudes concerning copyrights. 

Perhaps the most prevalent confu- 
sion arises in the infamous Public 
Domain. The law (in this case) is 
pretty clear: any work placed in the 
public domain is available for 
anyone to use for any purpose. 
Pretty simple. Yet all too often we 
receive manuscripts and programs 
at DDJ with copyright notices that 
read something like this: “Released 
to the public domain. Commercial 
use prohibited.” A legal paradox. 
How in the world can you enforce a 
right that you've given away? 

So if you've been wondering why 
DDJ publishes so much code with 
author copyright notices instead of 
donations to the public domain, that 
paradox should be a pretty good 
clue. Giving away all your rights to a 
program is an irreversible step and 
while most programmers like to 
share their ideas and programs with 
others, nobody likes to feel ex- 
ploited. Based on my informal poll- 
ing of programmers, that’s a big prob- 
lem with giving away software. In 
the last few years we've seen a 
number of bulletin boards, informa- 
tion utilities, and bulk disk vendors 
make more than a little money off 
the distribution of public domain 
software. 


Given the nature of the industry 
and DDJ’s tradition of sharing infor- 
mation with our fellow program- 
mers, it was clear that relying on 
articles dealing with PD software 
alone wasn’t going to cut it. The 
option of standing over our authors 
with a whip and trying to beat them 
into submissions (so to speak) just 
wasn't appealing. 

Our solution to the problem is 
not final or even particularly noble. 
We just print a magazine every 
month with articles, columns, and 
programs. We pay the authors for 
the rights to print their articles and 
source code. The authors get the 
usual fame and glory, a bagful of 
nickels, and an occasional letter com- 
plaining that their program makes 
the Fastbomb C compiler blow up. 

And what about the reader? What 
are your rights to the software? Well, 
despite all the lawsuits and para- 
noia in the software industry, the 
answer to that is pretty straightfor- 
ward. All of us—the authors, the 
editors, and the publisher—agree 
that once you buy an issue of DDJ 
you are entitled to use that issue's 
source code listings in any manner 
you want in the privacy of your own 
home, for the satisfaction of your 
intellectual curiosity. This is our 
family definition of “fair use. Copy- 
ing the code directly into your own 
programs and then distributing it is 
not what we call fair use. We call it 
tacky. Worse, our lawyers call it ille- 
gal. If you find yourself in a situation 
where you'd like to professionally 
use some code that appears in DDJ, 
please give us or the author a call. 
Odds are strong that a little polite- 
ness will be rewarded with a license 
that costs little (perhaps just a credit 
line), and everyone will feel better. 
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Aztec C 


Power to go the distance... 


Whatever that distance might be 


From real time embedded 
applications to comprehensive 
commercial applications on 
Macintosh, IBM PC, Amiga, 
Atari, and others, Aztec C has 
earned a well-deserved reputa- 
tion as an innovative, tough to 
beat, rock-solid C development 
system. 


But dont just take our word for 
it—try it yourself. We know that 
the best way to understand what 
puts you ahead with Aztec C is 
to use it. That's why Aztec C 


systems purchased directly from 
Manx come with a 30-day, no 
questions asked, satisfaction 
guarantee. Call for yours today. 


We can also send you informa- 
tion that details the special fea- 
tures and options of Aztec C. 
Plus information on support soft- 
ware, extended technical sup- 
port options, and all of the 
services and specialized sup- 
port that you may need when 
you're pushing your software to 
the limits and... beyond. 


Host+ Target: $750 Additional Targets: $500 


Targets: 

e@ 6502 family 

e 8080-8085-Z80-2180-64180 

© 8088-8086-80186-80286/8087-80287 
© 68000-68010-68020/68881 


Components: 

e C compiler for host and target 
e Assembler for host and target 
e linker and librarian 

e@ Unix utilities make, diff, grep 
@ Unix vi editor 

e debugger 

© download support 








Features: 

e Complete development system 

e Fast development times 

e@ Prototype and debug non-specific 
code under MS-DOS 

e Compilers produce modifiable 
assembler output, support inline 
assembly, and will link with assembly 
modules 

e Support for INTEL hex, S record, and 
other formats 

e source for UNIX run time library 

® processor dependent features 

e source for startup 
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Aztec C is available for most micro- 
computers in three configurations: 
The Professional; The Developer; and 
The Commercial system. All systems 
are upgradable. 


Aztec C68k/Am .... Amiga 
source debugger—optional 


Aztec C68k/Mac ... Macintosh 
MPW and MAC II support 


Aztec C86 ......... MS-DOS 
source debugger « CP/M libraries 


The following have special pricing and 
configurations. Call for details. 


Aztec C68K/At ..... Atari ST 

Aztec C80 ......... CP/M-80 

Aztec C65 ......... Apple 1 & Ii GS 
Standard System ............... $199 


@ C compiler 

@ Macro Assembler 

@ overlay linker with librarian 
@ debugger 

e UNIX and other libraries 

@ utilities 


Developer System .............. $299 
@ all Standard System features 

@ UNIX utilities make, diff, grep 

e@ UNIX vi editor 


Commercial System 
@ all Developer features 

® source for run time libraries 
@ one year of updates 


Aztec C is available on a thirty-day money back guarantee. Call 
now and find out why over 50,000 users give Aztec C one of the 
highest user-satisfaction ratings in the industry. 


C.0.D., VISA, MasterCard, American Ex- 
press, wire (domestic and international), and 
terms are available. One and two day deliv- 
ery available for all domestic and most 
international destinations. 


Manx Software Systems 
One Industrial Way 
Eatontown, NJ 07724 
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In NJ or outside the USA, 
call 201-542-2121 
Telex: 4995812 Fax 201-542-8386 
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RUNNING LIGHT 


ack in November 

I asked what I 
thought was a rela- 
tively innocent ques- 
tion: “Are you guys 
really using those list- 
ings or what?” Now, 
following the deluge 
of letters that column 
generated, I _ have 
some answers. You 
use the listings. 

The responses were interesting. 
Some of you were sure I planned to 
turn DDJ into another Byte by elimi- 
nating all the source code. In fact, 
several readers threatened to cancel 
their subscriptions immediately (as 
they had with Byte) if we stopped 
running the listings. Some readers 
pointed out that on-line access 
wasn't a practical option for all parts 
of the world. And a few, bless you, 
were charitable enough to note that 
I was asking for your feedback, not 
making a threat. 

So, to follow up the topic I intro- 
duced last November: Yes, there are 
changes coming for DDJ. And no, 
we're not killing the source listings. 

There are some repercussions 
from printing all that source code, 
however. As you must have noticed, 
a long listing can definitely limit the 
number of articles we can print in a 
given issue. Programs for the Mac 
and OS/2 environments seem espe- 
cially prone to source listings that 
are much longer than we're used to. 
We'll do our best to fit things in 
without resorting to continuing a 
program through several issues of 
the magazine, but sometimes there's 
no completely satisfactory solution. 
(This issue, for example, we had to 
postpone Stan Krute’s Mac column; 
next month it will run in its en- 
tirety.) 

Listings aside, there are some 
changes planned for the coming 
months. Chief of these is a new 
review section coordinated by Ron 
Copeland. This is not an attempt to 





woo readers from PC 
Magazine, thank you 
very much, but an at- 
tempt to get more in- 
formation to you 
about products of in- 
terest to program- 
mers. We'll be _ print- 
ing reviews of compil- 
ers and libraries, not 
roundups of printers 
'_| and surge protectors. 
Examining Room, a monthly collec- 
tion of short reviews debuts this 
month. As with the rest of the maga- 
zine, Examining Room is designed 
around your needs and feedback. If 
there’s a product you're particularly 
fond of then let Ron or me know by 
mail, e-mail, or phone. 

In other review news, it seems not 
everyone agreed with Allen Holub's 
review of C compilers a few months 
back. Check out the letters section 
for some of the flames from the 
CompuServe forum. 

On the home front, the chaos 
around here has abated significantly 
with the addition of our new manag- 
ing editor, Monica Berg. Monica is a 
veteran of innumerable deadline bat- 
tles, having just completed a tour of 
duty at Unix/World before signing 
on here at DDJ. 

One last note on this issue's 
theme before I go. Robert Ward's 
Debugging C (Que Corp., 1986) isn't 
a new title, but it is still one of the 
best books on the subject. He covers 
the traditional methods and the 
tricks specific to debugging C as 
well as the use of sdb and Code- 
View. Regardless of how you nor- 
mally work, if you're programming 
in C, you'll probably learn some- 
thing from this book. Highly recom- 
mended. 
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Ten Years Ago Today 

“One principal difficulty with newly 
evolving computer technology is that 
software generation tools generally lag 
corresponding hardware facilities, thus 
forcing the software engineer to resort to 
outmoded techniques to produce soft- 
ware systems.’—Gary A. Kildall, DDJ, 
February 1983. 


‘This is a long song folks, and 
tonight its going to be even 
longer’ 

“It is often true that along with articles 
of major import come listings of con- 
siderable length. Dr. Dobb’s Journal 
traditionally offers useful listings in their 
entirety, rather than just short excerpts, 
as illustrations for an article. Sometimes 
that means we do not have enough space 
to present the usual variety of articles, 
because the listings in a particular issue 
are so voluminous. But we are banking 
on the fact that the usefulness of the 
listings will more than compensate for 
those occasional times when the number 
of articles is fewer than normal.’—Marlin 
Ouverson, Editor, DDJ, August 1981. 


Yes, but Is It Turbo Compatible? 

“Partly as a matter of self preservation, 
we have become interested in the prob- 
lem of standards for the Pascal language. 
The United States Defense Department 
and many large industrial corporations 
have recently decided to use Pascal as a 
base language which they would extend, 
and possibly alter, to create system 
implementation languages.... We, and 
many others in the Pascal User Group, 
are very much concerned that all this 
extension and alteration activity will 
result in Pascal going the way of BASIC 
for which hundreds of dialects are in 
common use. We believe that a chance 
still exists to gain consensus on a sub- 
stantial family of Pascal extensions for 
system programming, provided that this 
can be brought about within the next 6 
to 12 months. Unless someone does so 
before us, we intend to convene a 
summer workshop for representatives of 
some of the major using organizations in 
the hope that such a consensus can be 
reached.’’—Kenneth L. Bowles, DDJ, March 
1978. 
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ve! Introducing Turbo C 1.50— 
the best optimizing compiler 
sets even better! 


The professional 
optimizing compiler 
for less than $100 
Turbo C® is a techni- 
cally superior produc- 
tion-quality compiler. 
(Borland’s equation sol- 
ver, Kureka”™, is written in 
Turbo C.) And our Turbo 
C 1.5 offers a new library 
of the highest presenta- 
tion-quality graphics in 
the industry—the kind 
you |] see in Quattro,” 





Our NeW professional Actual photograph of Turbo C graphics displayed on IBM 8514 screen.” 
spreadsheet. 
: And spectacular graph- ° Text/video functions, ¢ Sample graphics 

ics are just part of the including windows applications 

brand-new features. ¢ 43- and 50-line mode ¢ More than 100 new 

Turbo C 1.5 enhance- aeee functions 

ments also include: e VGA, CGA, EGA, Hercules, For professional-quality C 
A profésaional-cuelit and IBM 8514 support at an affordable price, no one 

e ‘esslonal-quallty ° File search utility (GREP else comes close to Turbo C. 
graphics library of over A Because no one can deliver 
70 functions technical superiority like 

e A librarian that allows you => Borland. 


to build your own object 
module libraries 


¢ Context-sensitive help for For the dealer nearest 
the language and the rR EOeE OH Ad you or to order, call 


library routines (800) 543-7543 


Minimum system requirements: For the |BM PS/2°™ and the |IBM° and Compaq® families of personal computers and all 100% compatibles. PC-DOS (MS-DOS®) 2.0 or later. 384K. 

“Artwork metafile courtesy of Genigraphics® Corporation 

**Customer satisfaction is our main concern; if within 60 days of purchase this product does not perform in accordance with our claims, call our customer service department, and we will arrange a refund. 

All Borland products are trademarks or registered trademarks of Borland International, Inc. Other brand and product names are trademarks or registered trademarks of their respective holders. Copyright ©1987 Borland International, Inc. BI 1165B 


60-Day Money-back Guarantee ** 
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It’s easy to upgrade to Turbo C 1.5! 
Just complete this coupon and mail it with payment before June 30, 1988. Or, call us at (800) 543-7543 and be ready to give our operators your name, 
credit card number, and the serial number on your Turbo C master disk. 
Please specify diskette size O 5%" O 31%" 








Turbo C 1.5 Upgrade Price $ 33.50 Method of Payment: O VISA O MC O Check O Bank Draft 
CA and MA residents add sales tax —____—__—_—__——_ Credit card expiration date: / 
Shipping and handling 

In US $5.00 (Outside US add $10) RTS Se ts ea: (PY fae PS es ee 
Total amount enclosed D scesitinnetenierttenslioad 


Name 

Must include your Turbo C serial #___EE 

Return this coupon and the Turbo C RTL source code registration form from your Turbo Ship Address 
C manual along with your payment by March 31, 1988 and receive your Turbo C 1.5 





upgrade for free! (No phone orders please.) City ___________ State 
Turbo C 1.5 Runtime Library et EE es eee 
Source Code $ 150.00 Mail coupon to: Turbo C 1.5 Upgrade Dept., Borland International 
CA & MA residents add sales tax we 4585 Scotts Valley Drive, Scotts Valley, CA 95066 
Fe es SU NEE Saas. This offer is limited to one upgrade per valid product serial number. Not good with any other offer from 
(Outside US add $10) oa Se ae Oe Borland. Outside US make payments by bank draft payable in US dollars drawn on a US bank. 
Total amount enclosed $ Sat een es CODs and purchase orders will not be accepted by Borland. DDJ 2/88 
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WATCOM unleashes a high- 
performance optimizing C compiler 
and development system that delivers 
superior results for every professional 
programmer and offers the fastest 
programming environment you can 
get your hands on. 


Producing the fastest, tightest code 
available today, WATCOM C6.0 
offers major advantages in large 
memory models and floating-point 
computation. 


The WATCOM C6.0 system includes 
WATCOM Express C (also sold sepa- 
rately), a seamless development envi- 
ronment complete with unexcelled 
diagnostic capabilities to maximize 
your productivity. 





Benchmark tests pitting WATCOM C6.0 
against Microsoft C5.0 and Turbo C 
demonstrate the optimum code size 
and speed your programs will achieve 
with WATCOM C6.0. Sophisticated 
register allocation, true register varia- 
bles and flow analysis allow your code 
to run its fastest. Moreover, extensive 
fine-tuning is possible with numerous 
user options like in-line substitution of 
machine code for performance-critical 
areas. 


We deliver more than performance. 
Flexible run-time conventions allow 
efficient interfacing to a wide range of 
libraries and language processors. 
WATCOM C6.0 supports small, 
medium, compact, large and huge 
memory models and the NEAR, FAR 
and HUGE keywords. 
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The fastest, tightest code 
(medium memory model*) 


The fastest, tightest code 
(small memory model*) 


| 2B 
“4 Iterations 
Sieve 





Dhrystone 





WATCOM C6.0 = Microsoft C5.0 Turbo C 


*IBM PC XT 


WATCOM C6.0 = Microsoft C5.0 


bytes *IBM PS/2 Model 60 
seconds 


Floating point computation 
108.5 


Turbo C 


Turnaround Time (compile + link/load) 
14.12 


WATCOM Microsoft Turbo Cc 
Express C Quick C 


Time in seconds to compile 573 source lines plus includes, 
and link 7 additional OBJ files created from 1391 source 
lines. |BM PS/2 Model 60, small memory model. Program 
used: GREP. 


IBM PS/2 Model 60 
with emulation 


-— Microsoft Turbo C 
CJ C5.0 ) 


Time in seconds to run 25 iterations of Whetstone. 
Small memory model (64K code, 64K data) 


IBM PC XT 
with 8087 


B WATCOM 
C6.0 
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Express C’s fastest available compile 
turn-around assists you with syntax 
and prototyping. With integrated 
tools like an editor and a symbolic 
debugger, you'll be amazed at how 
quickly you see your results. 
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Express C, included with WATCOM 
C6.0, has unique error checking that 
quickly uncovers many common and 
difficult bugs in “correct” code that 
other compilers miss. Take advantage 
of the powerful integrated debugging 
in Express C, then use WATCOM 
C6.0 for even tighter code and faster 
execution speed. Comprehensive 
compile-time and run-time messages 
enable effective programming prac- 
tices which you can extend with our 
fast development tools: MAKE, a 
disassembler, an object librarian 
and an overlay linker. 
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Because we know how valuable your 
time is, our on-line help is always 
available. Our software maintenance 
and licensing plans will keep you up to 
date. With them, our expert technical 
support is just a phone call away. 
When you create a great new prod- 
uct, our run-time library code can be 
licensed without royalties or account- 
ing. Naturally, training seminars are 
available at our Customer Education 
Center or your site. 


Mel 


AT 


The WATCOM C6.0 system delivers 
superior value, returning your invest- 
ment promptly by saving your valu- 
able time. Our twenty years of 
computer language experience began 
in 1965 when our WATFOR authors 
wrote the book on high-productivity 
debugging compilers. The WATCOM 
C compiler is based on the sixth ina 
series of 8086-family code generators 
used since 1981. Today, we remain 
committed to delivering world class 
programming tools. 








With WATCOM C6.0, you can debug large applications 
without extended memory. 


Superlative Performance Unparalleled Productivity | 


e Full ANSI C Optimizing Compiler e Full ANSI C Compiler 

e Source Editor © Integrated Source Editor 

e Full-screen Source-level Debugger e Integrated Debugger 

e Full ANSI C Run-time Library e Full ANSI C Run-time Library 

© Overlay Linker e Integrated Linker/Loader 

¢ Object Librarian List © Overlay Linker ad 

¢ MAKE syed © Object Librarian pees 
$495 $125 

e Disassembler e MAKE 

¢ Express C Introductory Introductory 

Price: Price: 


$295' $75' 


Available for IBM PCs, PS/2s and true compatibles with DOS. General availability March 1, 1988. 


*Limited time introductory prices apply only to prepaid orders (VISA/MasterCard). 
Shipping and handling extra. 


_______ | want to order WATCOM C6.0, 


regularly priced at $495 and well worth it, Please send me organization site 





for just $295. licensing information. 
______ | want to order WATCOM Please convince me further by 
Express C, regularly priced at $125 for sending a complete product description of 
just $75. WATCOM C6.0. 
Name Title 
Company 
Street 
City State Zip 


information needed for Credit Card orders: 


Signature Tel. 
Credit Card: Visa MasterCard 

Cat... hhc LlLUlLc Ll EXD HON Cle 
Dept. DD-02B 


1430 Massachusetts Avenue 
Cambridge, MA 02138 


WATCOM C and WATCOM Express C are trademarks of WATCOM Products Inc. ©Copyright 1988 WATCOM Products Inc. 
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More Listing Pros and 
Cons 

Dear DDJ, 

In the November 1987 “Running 
Light,’ you asked whether it was 
sensible to print source code list- 
ings. I think it is definitely a good 
policy for three reasons: some, like 
me, have no other access to listings; 
studying the printed listings is help- 


ful in understanding a program; and — 


those who peruse DDJ away from a 
telephone would appreciate printed 
listings. 

You mustn't assume that every- 
one has ready access to a fast 
modem or has the money to 
buy one; I have limited re- 
sources and cannot afford a 
modem. Studying the printed 
listings is useful in under- 
standing a program and its 
accompanying article. It // 
would be maddening to read } * 
in the text “see line 97” with- 
out the listing at hand, espe- 
cially if you're in a library. | 
Finally, those who flip 
through DDJ in bookstores 
may decide to buy based on | 
the listings. I have. In fact, I | 
bought several issues at full | 
retail before subscribing. So 
please don’t stop printing 
source code listings in DDJ— 
they're most useful. 

Dan Velting 

Grand Rapids, MI 49506 


Dear DDJ, 

November 1987’s Running 
Light provided a long over- 
due relief. Is it true, you are 
really going to spare me the 
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monthly trip to my _ not-so-local 
newsagent? My sole reason for going 
there is to pick up a certain com- 
puter magazine featuring full-length 
source listings. If said magazine 
stops publishing those listings, I in 
turn shall stay home near the warm 
oven, which comes in handy with 
winter almost upon us. 

Were I mad enough to use the 
twisted pair to download the source 
code absent from DDJ's pages, the 
post office would charge me $8.40/ 
minute for a phone call to the US. If 
the rare occasion should indeed 
find me in a spending mood, it 
would still be in vain, as your Bell 
standard modem finds itself unable 
to talk to my V21/V22/V23 DCE. 

No, if you want me to keep on 
getting cold and wet feet, you will 
continue to print listings in DDJ. 
But who could be that cruel? 

Andreas Burmester 

2000 Hamburg 70 

West Germany 


Dear DDJ, 

Keep the listings! Not all of us have 
sold our souls to IBM and MS-DOS. 
Not all of us live where CompuServe 
is a local call or can afford the 





After weeks of unsuccesful debugging, 


Gordon resorted to a hardware breakpoint. 





charges. Not all of us have a 2,400- 
bps modem. 

The listings are the foundation of 
DDJ. How do you read an article 
about a program without access to 
the code? If you do away with the 
listings, you'll be just another Byte— 
bland pap for computer illiterates. 

Mad at you for even suggesting 
such a thing. 

Donald Lashomb 

Cranberry Lake, NY 


Turbo Wars 

Editor's note: A brief storm of con- 
troversy blew up on CompuServe fol- 
lowing Allen Holub’s comments on C 
compilers in his October 1987 “C 
Chest” column. A sample from the 
thread follows: 


Sb: C reviews 10/87 
Fm: Jeff Brenton 76703,1065 
To: Allen Holub 72407,3564 
Dear Allen, 
Is Turbo C a better product than 
Quick C? Probably not, but, until 
mere mortals can purchase and re- 
ceive Quick C, Turbo is a better prod- 
uct for the “interested in C, but no 
corporate backing available for my 
education” user. As I write this note, 
no one I know of has re- 
ceived Quick C, including 
people who ordered it di- 
rectly from Microsoft as part 
of the version 5.0 upgrade. 
On the other hand, Turbo 
C, though it lacks even a sym- 
bolic debugger, has been in 
my hands since July, and gen- 
erates better code (for the 
most part) than v.4.0 of Micro- 
soft C. The fast compile times 
make it much more “fun” to 
use than any other compiler 
I have access to. Its earlier 
delivery, combined with its 
performance and low cost, 
made it possible for Borland 
to sell more Turbo C pack- 
ages than Microsoft ever sold 
of MSC, just in the first 
months after its release! I 
wouldn't be surprised __ if 
Borland manages to triple Mi- 
crosoft's C compiler sales 
before Quick C hits the 
market. 
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Stunning speed. Unmatched performance. Total flexibility. Simple 
and intuitive operation. The newest VEDIT PLUS easily satisfies 
the most demanding computer professional. 


The free demo disk is fully functional—you can try all features 
yourself. Best, the demo includes a dazzling menu-driven tutorial 
— you experiment in one window while another gives instructions. 


The powerful “macro” programming language helps you eliminate 
repetitive editing tasks. The impressive demof/tutorial is written 
entirely as a “macro—it shows that no other editor’s “macro” lan- 
guage even comes close. And VEDIT PLUS is only 40K in size. 


Go ahead. Call for your free demo today, You'll see why VEDIT 
PLUS has been the #1 choice of programmers, writers and engi- 
neers since 1980. 


The installation lets you pick from closely emulating the keyboard 
layout of Word Perfect, WordStar and others. Or you can easily 
create your own layout and even your own editing functions. Sup- 
ports any screen size—you pick screen colors and attributes. 


Supports the IBM PC, XT, AT and PS/2. Also supports MultiLink, 
PC-MOS/386, Concurrent DOS and most networks. Also avail- 
able for MS-DOS, FlexOS (protected mode), CP/M-86 and CP/M. 
(Yes, we support windows on most CRT terminals, including CRTs 
connected to an IBM PC.) Order direct or from your dealer. $185. 


Special: VEDIT (single file, no windows) for CP/M—$49. 


& TeleVideo 


VEDIT and CompuView are registered trademarks of CompuView Products, Inc. BRIEF is a trademark 
of UnderWare, Inc. PMATE is a trademark of Phoenix Technologies Ltd. Norton Editor is a trademark 
of Peter Norton Computing Inc. MultiLink and PC-MOS/386 are trademarks of the The Software Link, 
Inc. CP/M and FlexOS are trademarks of Digital Research. MS-DOS is a trademark of Microsoft. 


“Also available for Tl Professional, Tandy 2000, DEC Rainbow, Wyse WY700 and others. 
“Demo disk is fully functional, but does not readily write large files. 
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Call 1-800-45-VEDIT for 
FREE Fully Functional Demo Disk 








e Fully Network Compatible 
e Call for XENIX-286 version 
e 30 Day Money-back guarantee 
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BRIEF Editor PMATE 

‘Off the cuff macros No No Yes 
Built-in macros Yes No Yes 
Keystroke macros Only 1 No No 
Multiple file editing 20 + 2 No 
Windows 20 + 2 No 
Macro execution window No No No 
Pop-up menus No No No 
Execute DOS commands Yes Yes Yes 
Automatic processing of 

Compiler errors Yes No No 
“Cut and paste” buffers 1 1 1 
Undo line changes Yes No No 
Paragraph justification No No No 
Convert to/from WordStar No No No 
On-line calculator No No No 
Configurable Keyboard Hard No Hard 
43 line EGA support Yes No No 
Manual size/index 250/No 42/no 469/Yes 
Benchmarks in 120K File: 
2000 replacements 1:15 min 34sec 1:07 min 
Pattern matching search 20sec Cannot Cannot 
Pattern matching replace 2:40 min Cannot Cannot 









CompuView 


1955 Pauline Blvd., Ann Arbor, MI 48103 
(313) 996-1299, TELEX 701821 





LETTERS 


(continued from page 12) 





(Borland's currently estimates Turbo 
C sales at over 150,000.—Ed.) 

In spite of learning C in the old 
separate-everything environment, I 
still use Turbo C’s integrated envi- 
ronment, since I haven’t needed to 
use inline assembly yet. For the sort 
of quick and dirty stuff I do, I have 
grown to accept the clunky editor 
in exchange for the way it drops me 
into the editor and shows me “the 
error of my ways.’ I still use the 
DeSmet SEE editor for writing and 
modifying programs, however. 

I also appreciate Borland'’s inten- 
tion to deliver a “conforming” ANSI 
C compiler, as opposed to Micro- 
soft’s intention to “implement the 
important aspects” of the proposed 
ANSI standard. 

I will not purchase Quick C by 
itself; I will wait until I can afford to 
buy the full Microsoft C v. 5.x pack- 
age. After all, programming is but a 
hobby for me at this time, and I 
don't have a company buying my 
compilers for me. If Quick C had 
been available in June, like Turbo C, 
I might have bought it instead, but 
it wasn’t, so I bought my first 
Borland product ever. 

Sincerely, 

Jeff Brenton 

Woodstock, IL 


Dear Jeff, 

Your points about availability are 
well taken. Quick C was supposed 
to be available by now. As for “con- 
forming” to the ANSI standard (or at 
least conforming as well as possible 
to what is, after all, a moving target), 
both compilers are the same. As for 
conforming to the de facto Unix stan- 
dard for the non-ANSI functions, Mi- 
crosoft is far superior to Turbo. 
There are problems with the Micro- 
soft Unix support (such as no 
ioctl()) but I'd rather have no func- 
tion at all than some function that 
calls itself toctl() but has no rela- 
tionship to the Unix function what- 
ever, as is the case with Borland. 


Signal is another case in point. 
—Allen 


Dear Allen, 

Your example of ioctl() is a rather 
poor choice. By definition, such a 
function must be OS-specific; the 
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version in Turbo provides “a direct 
interface to the DOS ioctl call,” just 
as ioctl() provides access to the Unix 
system call. Sure, it is wonderful to 
have a function hide the differences, 
but, since you are already dickering 
with system-specific code, what 
good is ‘portability’? 

You call the Draft ANSI Standard 
for C a moving target, and then 
point to Microsoft's adoption of the 
“de facto Unix standard.’ Which 
one? Version 7, System III, System V, 
BSD? If SysV or Berkeley, which re- 
lease? There are many differences, 
both major and minor, between the 
C compilers in these Unix systems! 
The Unix “standard” doesn't have to 
move—it is so broad, that you can 
call virtually any variation on a func- 
tion’s actions “Unix standard”. 

That was the whole purpose of 
X3J11—to establish a true standard, 
one that allowed some _ leeway. 
There are a minimum number of 
functions, headers and macros that 
must be there to be “conforming,” 
and their use means portability to 
other complying compilers. Borland 
says they are shooting for full com- 
pliance. Microsoft says ‘the impor- 
tant parts.” But who decides what 
is important enough to include? 
With all the fighting that went on 
over what was in and out of the 
standard, ANSI must think all of it is 
important! 

I probably will get Quick C and 
Microsoft C 5.0 eventually. But 
Turbo C has and will continue to 
do well for me. Upon its arrival, 
DeSmet and Eco both left my hard 
disk. Turbo C takes up less space, 
generates code better than most, 
and most of the major bugs have 
been fixed in my copy. 

C you around! 


Sb: #Datalight Optimum-C 

Fm: Dave Searles 73647,1011 

To: Allen Holub 72407,3564 

Allen... I just read your review of 
Datalight Optimum-C in the Octo- 
ber DDJ. I agree with your assess- 
ment of the compiler except for one 
major point. Optimum-C does sup- 
port debugging as it does produce 
line number information with the 
‘-g’ option. Granted that a Codeview- 
type debugger isn't included, but I 


have been very happy with my com- 
bination of Optimum-C and Peri- 
scope II. I have all the benefits of 
Microsoft C at less than half the 
price. And as far as I can tell, I’d put 
Periscope up against Codeview any 
day, especially Periscope version III. 
Nothing beats a resident debug- 
ger.... Its great when you suddenly 
notice an anomaly in a previously 
“debugged” piece of code... just hit 
the NMI switch and snoop around. 
Sorry for the sales pitch, but I 
thought you gave Datalight a cheap 
shot, even after they have given all 
of us a cheap shot at a really good 
compiler. 


Fm: Bruce Kitchin 75046,1131 
I really take exception to the as- 
sumption made by a number of 
people (usually but not always those 
who have little or no experience 
with Turbo C or in one case I re- 
member, a person who used it for a 
day, ran into a glitch and gave it up 
and told the world that it was bad) 
that Borland products are _ for 
Sunday hackers. In the DDJ article, 
it was admitted that Turbo C some- 
times generated better code than 
MSC 4.0 but not as good as MSC 5.0. 
For the price, I hope that MSC 5.0 
generates better code, that has not 
been MSC's strong point up till now. 
Without looking at price, I have 
found it difficult to see much supe- 
rior about MSC 4.0 over Turbo C and 
I have found some ways in which 
Turbo C is superior (not including 
its greater conformance to the draft 
ANSI proposal which I assume that 
MSC 5.0 will catch up with, that is 
just a matter of release dates versus 
when ANSI updates the draft—a 
moving target). I’ve used both com- 
pilers with a program that contains 
many source files with a total line 
count approaching 20,000. The final 
code of Turbo C is smaller with both 
optimizing for space, I’ve examined 
a lot of code with both and find a 
toss up (depends on where you 
look), and Turbo C gave me better 
warnings about ambiguous code, 
about 20 percent of which were 
latent bugs that I would have had 
to debug when running. 


DDJ 
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The Leaders Made PVCS 
The Leading Source Code Control Systems a 


hen it comes to maintaining their most 

valuable asset, the leading software 
publishers rely on the POLYTRON Version Con- 
trol System (PVCS). From accounting firms to 
airlines, the leading service companies depend 
on PVCS to maintain the integrity of their pro- 
grams. Leading manufacturing companies use 
PVCS to maintain their state-of-the-art software. 
Leading high technology companies turn to 
PVCS to handle configuration management for 
software projects that represent an investment 
of hundreds of thousands of dollars. The largest 
aerospace companies and defense contractors 
use PVCS to maintain integrity of projects during 
development and after delivery of software. 
Independent programmers use PVCS to 
improve their productivity and software quality 
for themselves and their clients. 


Simplify 
Configuration Management 


When large and complex software programs are 
being developed on personal computers or VAX 
minicomputers, effective management of the 
revisions and versions becomes critical. PVCS 
simplifies this process and lets you effectively 
control the proliferation of code changes. We 
used UNIX SCCS and RCS as models. How- 
ever, Our Own experience, and the input of 
hundreds of programmers and managers has 
enabled us to significantly improve upon these 
models. 


PVCS provides many 
powerful functions including: 
e Storage & Retrieval of multiple revisions of text. 
e Maintenance of acomplete history of changes. 
e Maintenance of separate lines of development 
using branching. 
e Merging simultaneous changes. 
e Resolution of Access Conflicts. 


e Modules can be retrieved by their own revision 
number, system version name, or specified 
date. 


e Uses “reverse deltas” to rebuild a prior version 
making PVCS the fastest version control 
system over the project life cycle. 


e Projects already under developmentor inthe 
maintenance stage can be easily put under the 
control of PVCS. 


Manages Development On 
Local Area Networks 


Programming teams using Local Area Networks 
depend on PVCS to help the managers and 
team members work together. In fact, Novell and 
3Com themselves depend on PVCS to manage 
the versions of their own network software 
products. 


Supports MS-DOS 
and VAX/VMS Development 


Now, companies that develop software on VAX 
systems running VMS can also use PVCS. And 
since the VMS and MS-DOS versions of PVCS 
use the same “logfile” format, you can easily 
develop software on PCs and maintain the code 
on the VAX or vice versa. The menu-driven, 
screen-oriented interface (and optional 
command-driven interface) makes it easy for 
programmers and librarians or administrators to 
use PVCS on a PC or VAX or both systems. 


PVCS Maintains System 
Integrity 


PVCS prevents corruption of code that could 
ordinarily result from security breaks, user care- 
lessness or malfunctions. The levels of security 
can be tailored to meet the needs of your project. 


PVCS & PolyMake 
Work Together 


PolyMake, the leading MS-DOS make utility, is 
now available for the VMS operating system. 
This allows you to write makefiles that will func- 
tion in both PC and VAX environments. Addition- 
ally, PolyMake reads time & date stamps of PVCS 
archives for fast, accurate program rebuilding. 


PVCS and PolyMake Maintain 
Source Code Written In 
Any Language. 


Only PVCS meets the needs of independent 
programmers and corporations. Once you stan- 
dardize on PVCS, the archives used to track and 
monitor changes are interchangeable between 
any PVCS product. You will receive full credit for 
your initial purchase if you upgrade to a higher- 
priced MS-DOS version of PVCS. 


Personal PVCS — Offers most of the power and 
flexibility of Corporate PVCS, but excludes the 
features necessary for multiple-programmer 
projects. 


Corporate PVCS — Offers additional features to 
maintain source code of very large and complex 


projects that may involve multiple programmers. 
Includes multi-level branching to effectively main- 
tain code when programs evolve on multiple 
paths (e.g. new versions for different host 
systems, or anew program based on an existing 
program). 


Network PVCS — Extends Corporate PVCS for 
use on Networks. File locking and security levels 
can be tailored for each project. 


PVCS for VAX systems — Requires VMS. Uses 
the same interface and archive format as MS- 
DOS version. Supports branching and offers file 
locking and other security features for multiple- 
programmer projects. 
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The Preferred 
Version Control System 


The customers listed below are just a few of the 
innovative leaders that have made PVCS the 
leading version control program for personal 


computers. 


Alcoa Aluminum 

Arthur Anderson 

AT&T 

Ashton-Tate 

Bank of America 

Bell Labs 

Bendix 

Boeing 

CIGNA 

Citibank 

3Com 

Colonial Penn 
Commerce Clearing House 
Control Data Corp. 
Corvus 

CX| 

Digital Equipment Corp. 
Deloitte Haskins + Sells 
Diebold 

Dow 

Dunn & Bradstreet 

EDS 

Educational Testing Service 
E-Systems 

Equitable Life 

Federal Express 

First Boston 

Ford 

Fox Software 

Fujitsu 

GTE 

Hardees 
Hewlett-Packard 
Honeywell 

Hughes Aircraft 

IBM 

Industrial Networking 
Intel 


ISC Aerospace 

IVAC 

Javelin 

Lattice 

Lawrence Livermore 
Lotus 

McData Corp. 
McDonnell Douglas 
Mead Data Central 
MIT Lincoln Labs 
Nastec 

Novell 

NCR Technologies 
Pitney Bowes 
Plexus Computers 
Price Waterhouse 
ROLM 

Rockwell International 
Safeco 

Sears 

Security Pacific 
Sperry 

Software Publishing 
Spacelabs 

Standard Oil 
Standard & Poors 
Tandem 

Tektronix 

Telex 

Texas Instruments 
Touche Ross 

Unisys 

United Airlines 
United Parcel Service 
United Technologies 
U.S. West 
Westinghouse Electronics 
Xerox 


ee 


Personal PVCS 


NetworkPvcs | $995** | $4950 | $9,500 |$10500+ 
Network $447** | $1,250 | $2,375 | $2,500+ 
PolyMake 


*Compatible with MS-DOS 2.0 through 3.3. 
Compatible with the IBM PC/XT/AT & other 





MS-DOS PCs. 


**5 Station LAN License. Call for pricing 


on larger Networks. 


TO ORDER: 
VISA/MC 1-800-547-4000. 
Dept. No. 355 
Oregon & Outside USA call (503) 645-1150. 


Send Checks, PO.s to: POLYTRON 
Corporation, 1815 NW 169th Place, 
Suite 2110, Beaverton, OR 97006. 
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High Quality Software Since 1982 
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‘Texas Instruments has 
system developers need. 
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“Personal Consultant™ Plus oo offers Personal nae Plus 3.0 Standard Features 


— Frames, rules, meta rules and procedures 
— Forward/backward chaining 


a very fine expert system development fe 


— End-user explanation facilities 


and delivery tool that already has Ee as 


.EXE or .COM programs, “C’ 


— Complete LISP development environment 


a proven record with end-users.” = Zoid expandedeended mer suppor 


~ eat we help 
— “Getting Started” tutorial-style manual 
— Susan Shepard, Al Expert : : 
Personal Consultant Images 
— Optional add-on package to PC Plus (3.0) 
— Allows integration of “active images” into 





what serious expert 


Power tools. 


Prscisas all the expert system devel- 
opment tools available for personal 
computers today, none deliver the 
power and flexibility of TI’s Personal 
Consultant series. 

Personal Consultant Easy is ideal for 
getting started, and is upwardly com- 
patible with the higher functionality of 
PC Plus. For experienced developers, 
Personal Consultant Plus and its 
optional add-on enhancements, Online 
and Images, were designed to help solve 
a broader range of complex problems. 


PC PLUS 


Interfaces with: 
« Lotus 1-2-3 


« DOS files 


EXPLORER 
Common LISP Delivery 


Personal Consultant Plus. Full power 
for an affordable price. 

At $2,950, PC Plus has proven to be 
one of the richest and most flexible 
problem-solving tools available for the 
development of complex knowledge- 
based systems. Designed to take 
advantage of today’s more powerful 
286/386 DOS-based computers, or TT’s 
Explorer™ Symbolic Processing System, 
the new 3.0 version of PC Plus provides 
powerful standard features and a contin- 
uing growth path with the addition of 
either PC Images or PC Online, or both. 


Personal Consultant Images. Picture 
an expert system with interactive 
graphics. 

At $495, PC Images enables developers 
to create knowledge-based applications 
that incorporate complex graphical 
“active images.” User-interactive dials, 
gauges, forms and selection images pro- 
vide a more exciting visual data input 
and output style. 

















knowledge bases 

— Interactive dials, gauges, forms and selection 
images 

— Multiple images can be combined on same 
screen 

— “Getting Started” tutorial-style manual 


Personal Consultant Online. The 
expert system as part of the process. 
At $995, PC Online allows the devel- 
oper to design expert systems which 
interact directly with process data, as 
opposed to input from a human oper- 
ator. Designed for intelligent process 
monitoring applications, this optional 


Personal Consuitant Online 

— Optional add-on package for PC Plus Lae 

— ONLINE expert systems that interact directly with 
rocess data 

— Multiple interfaces to data acquisition and 

analysis programs 

- la base synchronization with process 
ata 

— Functions for historical and predicted trends 

- So user interface/reporting capabilities 

— “Getting Started” tutorial-style manual 







¢ dBase Il, Ill, Ill Plus 


Customize in LISP or “C” 





package helps deliver expertise that is 
“online all the time.” 


Application delivery as flexible as the 
tools themselves. 

Delivery can be in LISP for flexibility, 
or “C”* for maximum speed and porta- 
bility. Our “C” options support either 
stand-alone or “embedded” knowledge 
bases. Options are available for DOS- 
based PCs, TI’s Explorer, and DEC’s 
VAX™ line of multi-user minis running 


under VMS™. 


Frames, rules, meta rules, procedures PC ONLINE 


Process Monitoring 


« EXE and .COM programs PC IMAGES 


Active Images 


VAXVMS © 
“C’ Delivery 
Embedded or Stand-alone 


“Texas Instruments has done more 
than any other company to educate 
people about AI, to popularize it, and 
to make useful AI tools available at 
reasonable prices.” 

— Jim Seymour, PC Magazine. 


Technical support, training courses and 
Knowledge Engineering Services are 
available for the Personal Consultant 
products. If you have a question about 
any of our expert system power tools, we 
have the answer. 


Pick up the phone and gain a powerful 
advantage. 

Call 1-800-527-3500 for technical 
overviews of our products and a PC Plus 
case histories brochure which details 
how our power tools are being put to 
work today. 


36106 
© 1987 Tl 
Personal Consultant and Explorer are trademarks of 
Texas Instruments Incorporated. 
dBase is a trademark of Ashton- Tate. 
Lotus 1-2-3 is a trademark of Lotus Development Corp. 
VAX and VMS are trademarks of Digital Equipment Corporation. 
* Available 4Q 1987. 
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Debugging with 
the 80386 





Notes on real mode debugging with the 386 


by Franklin Grossman 


praise for its improvements over the earlier 80286. 

Much has been written on the excellent speed and 
(essentially) flat address space of the 386. In developing 
software, however, there are other concerns that are just 
as important as operating speed, even though fast devel- 
opment is often a critical factor. In this article I'll discuss 
some of the advantages of the 386 processor from the 
perspective of software debugging. 

When Intel designed the 80386, it included a new 
feature: hardware support for. debugging. Probably the 
most important addition of the new debugging support 
was the inclusion of breakpoint registers, which allow 
breakpoints on memory reads, writes, and instruction 
fetches. Although breakpoint registers are powerful, they 
do have limitations. By using a few other features of the 
80386, our company was able to create a software 
debugger that contains most of the features found in 
hardware-assisted debuggers. In addition to breakpoint 
registers, our product, Soft-ICE, uses several protected 
mode features, such as virtual 8086 mode, paging, I/O 
privilege level, and breakpoint registers, to add real-time 
hardware-level breakpoints and other features found 
only in hardware-assisted debuggers to existing DOS 
software debuggers. This article describes how these 
80386 features work and how our debugger uses them. 


| Ee 80386 processor has received a great deal of 


Virtual-Machine Capability 
All 80x86 real-address-mode software debuggers cause 





Franklin Grossman is the president of Nu-Mega Technolo- 


gies and one of the principal designers of the Soft-ICE 
debugger. 
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side effects to the program environment. These side 
effects are caused because the debuggers use memory, 
interrupt vectors ([INT 1], [INT 2], and [INT 3]) and DOS 
or BIOS for I/O. Software debuggers are also at risk of 
being overwritten or affected in other ways by the target 
program. For this reason, many hardware-assisted de- 
buggers load the debugging code into write-protected 
memory on an option card. Even this solution can cause 
side effects because that memory is mapped into the 
lower Mbyte that is visible to the 80x86 processor in 
real-address mode, and this address space (such as 
CO000H or DOOOOH) is also used by other adapter cards. 
By using the 80386 in virtual 8086 mode, though, it is 
possible to write a debugger that surrounds the DOS 
environment in a virtual machine without any of the 
side effects mentioned earlier. 

The 80386 provides a virtual 8086 capability intended 
for use by protected mode operating systems. This 
feature was necessary because 80386 protected mode is 
not backward compatible with 8086 executable pro- 
grams. The 8086 virtual-machine capability is imple- 
mented in such a way that a protected mode operating 
system can allow multiple virtual 8086 tasks that are 
controlled by the operating system kernel, and so the 
operating system and other native tasks are isolated 
from ill-behaved DOS programs. The operating system 
cannot be overwritten by the DOS program and has 
complete control over interrupts, I/O, and the memory 
map. 

Several operating systems commercially available today 
use the virtual 8086 mode of the 80386. These include 
FlexOS (DRI), PC-MOS/386 (Software Link), VPix (Phoenix 
Technologies and Interactive Systems), and Windows/ 
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DEBUGGING WITH THE 80386 
(continued from page 18) 





386 (Microsoft). 

If you think of the model described earlier but replace 
the operating system with a debugger, you get some 
interesting benefits. The debugger can control the 8086 
environment without affecting it or being affected by it, 
and the debugger code does not run in the virtual 8086 
task and therefore is not visible to DOS or to DOS 
programs. To implement a debugger based on this 
model, the debugger must have many features of an 
operating system, including a complete I/O system—the 
debugger cannot rely on DOS or BIOS for I/O. 

A protected mode debugger has more control over the 
virtual 8086 task than is possible with a conventional 
software debugger. Interrupts are controlled because all 
interrupts go through the protected mode interrupt 
table to the protected debugger. (It is the responsibility 
of the protected debugger to generate the interrupt in 
the 8086 virtual machine if necessary.) I/O is controlled 
because the protected debugger has control over which 
IN and OUT instructions are passed through to the 
hardware and which cause exceptions (80386 excep- 
tions are very similar to 8086-style interrupts). The 
memory map is completely controlled by the 80386 
paging mechanism. Using paging, the amount of memory 
given to the virtual machine can be varied in 4K incre- 
ments up to 1 Mbyte. In most instances 640K is the right 
number. Memory pages can also be marked as “not 
present,’ causing an exception if a program running in 
the 80386 virtual machine accesses that memory page 
and so giving the debugger control over access of 
memory regions. 

This article describes how protected mode features 
can be used to provide sophisticated debugger break- 
points. The breakpoints are generally implemented by 
gaining control of the processor when an exception 
occurs. At this point a debugger window can be popped 
up or control can be given to a conventional DOS 
software debugger. This process is described in detail 
later. 


Breakpoint on I/O 

A useful feature in debugging device drivers is having 
breakpoints on IN and OUT instructions. IN and OUT 
instructions execute under control of the protected 
debugger. The 80386 gives the operating system the 
ability to trap on accesses to any I/O address, a capability 
that was included to allow the operating system to 
“virtualize” the I/O of an ill-behaved DOS program. An 
example of this would be capturing bytes output to the 
parallel port in a printer driver application, where the 
protected mode operating system could send these 
bytes to a print spooler. 

The 80386 allows the protected mode operating system 
to control the virtual machine’s access to I/O ports 
through a bit mask. The bit mask contains a separate bit 
for each 8086 I/O port. If the bit is clear, the 80386 lets the 
IN or OUT instruction execute normally. If the bit is set, 
the 80386 generates an exception that is handled by the 
protected mode operating system. I/O addresses range 


from 0 to 65,535, so a complete bit mask takes 65,536 bits, 
or 8K of memory. If the protected mode operating 
system provides a bit mask of less than 8K, then any 
accesses to I/O ports that are not covered by the bit mask 
cause an exception. 

Our protected debugger takes the place of the pro- 
tected mode operating system, using the I/O bit mask to 
provide breakpoints on IN and OUT instructions. To set 
an I/O breakpoint, the debugger sets the bit that corre- 
sponds to the specified I/O address. When the target 
program running in the virtual 8086 task accesses that 
YO address, an 80386 exception occurs. An 80386 excep- 
tion is similar to a software interrupt. At this point the 
debugger has control, but it does not know if an IN, INS, 
OUT, or OUTS instruction caused the exception. 

The protected debugger’s exception handler can look 
at the actual instruction that caused the exception to 
determine the instruction type. More specific break- 
points are possible by comparing the actual value being 
output with a predefined value. In the case of an input, 
the instruction can be single-stepped and the value in 
the AL or AX register compared with a predefined value. 
If these specific criteria are not met, the debugger can 
give control back to the virtual 8086 task. 

One advantage of using the 80386 virtual-machine 
features to cause I/O breakpoints is that 80386 excep- 
tions occur instantaneously. This may not seem like a 
revolutionary statement, but the builders of hardware- 
assisted debuggers and in-circuit emulators have been 
confronted with this problem for years. As microproces- 
sors become more pipelined, it is difficult to cause an 
instantaneous breakpoint—for example, most hardware- 
assisted debuggers generate an NMI (nonmaskable inter- 
rupt) when the breakpoint conditions are met. Because 
the 80386 prefetches and predecodes several instruc- 
tions before the actual target instruction is executed, the 
80386 has actually executed several instructions before 
it recognizes the NMI. 


Breakpoint on Interrupt 

When debugging, it is often useful to set a breakpoint 
on a hardware or software interrupt. You may, for 
example, want to run a program until it makes a DOS 
call to read the version number. You could set a break- 
point for INT 21 with AH = 30. Interrupt breakpoints are 
a natural for protected debuggers. 

In our protected debugger, all interrupts go through 
the protected mode interrupt table that is under com- 
plete control of the debugger. It is the responsibility of 
the protected debugger to get the address from the 8086 
virtual mode task’s interrupt vector table at 0:0 and 
transfer control to that address. With a little additional 
qualification code that compares the interrupt number 
with a value previously input by the user, you have 
breakpoint-on-interrupt capability. This method works 
equally well with hardware or software interrupts. 


An End to Hung Programs 

Another debugging feature that can be implemented 
using the virtual machine is the ability to pop your 
debugger up at any time, even if interrupts are disabled 
or masked off. Often, when a program is hung, it is 
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A Number of Reasons A Number 


Thousands of DOS Programs PC-MOS/386™ 
@ gives you the best of the past, and the best for your 
P future. Which means that while PC-MOS/386™ totally replaces 
"your old DOS, you won’t have to replace the programs you’ve 
sade a lot of time learning. 

tm, And it all happens so effortlessly. You’ll continue 
to reap the benefits of your favorite DOS programs, 
while entering a new arena of power. 

2 Think of it! Programs like dBASE III, 
= WordPerfect, Lotus 1-2-3 and Sym- 
== phony, WordStar, MultiMate... literally 
= thousands of DOS programs-all com- 
& patible and multi-user available. 









1 Designed AR 

e for the 80386 There's Tar! 

revolution taking place in desktop cocaine A revolution 
that’s been launched by a square wafer of silicon known as the 
80386 microprocessor chip. It puts minicomputer potential at __ ee = 
PC users’ fingertips. It’s a fact that virtually every leading PC ““Sauuuy jo ON 
manufacturer has built a “box” around this chip. And it’s a fact a 

that the “New Operating System” will, supposedly, even run < 


on it. But, it’s also a fact that cherr system wasn’t designed for 
the 80386. Ours is. Andit’s , J) called PC-MOS/386™ 














PC and PS/2 BP Familiar 
e Compatible e Commands 


In designing PC-MOS, we Like DIR and COPY 


knew our first priority was Just as you don’t have to 


to exploit the minicomputer _ learn a whole new array of & orem } ced 
capabilities of 80386-based software to take advantage of PC -M0S)386° neither oe you 


PCs & PS/2s. But we went —_ have to learn an entirely new set of commands. 

further, and developed a Instead, the system builds on the knowledge you already 
ro § If system which would be fully have. “COPY” still copies files, and “DIR” still gives you a 
compatible with the millions of J existing PCs, PC ATs, and _directory listing. As you might expect, we didn’t stop there. 
PC-compatibles. Power without Mf sacrifice. You'd expect There’s a wealth of features that have strengthened the com- 
nothing less from the new standard bearer. mands you know, making them more powerful and easier to use. 








One, Five, Up to Twenty-five Users 
@ From the beginning, PC-MOS/386™ was _, stations. Mix and match dumb terminals 

designed as a versatile operating system which costing under $500 each with PCs and 
could support twenty-five users as easily mF ' _ PS/2s running our terminal emulation 
as it supports one. The system comes in  (geeumum Guam soltware. 
single, five, and 25-user modules, so All of the host’s resources can be 
you're able to start with what you need S| shared. Programs, data, hard disks, 
and expand when you're ready. tape backup units & printers (including 

In a multi-user setting, PC-MOS/386™ uses the high speed laser printers) are suddenly available to all 
computing power of the host PC to drive workstations =| users. An 80386-PC has minicomputer potential. 
linked to standard RS-232 ports. ==) With PC-MOS/386™ you can “mini” your micro. 
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You can choose from a variety of work- 












Concurrently Supports Virtual 8086 and 
e 80386 32-Bit Mode 





80386-based PCs & PS/2s are dual-personality computers. ‘Io 

run DOS programs, they act as PCs with a 640K memory limit. 
But to take advantage of their minicomputer capacity, they operate 
in true 80386 mode which lets them address up to four gigabytes 
of memory. PC-MOS enables the 80386-host and its workstations 
to independently switch between these modes-making DOS 
compatibility and 80386 power simultaneously possible. 


Multi-Tasking 

@ While it’s true you could look else- 

where for multi-tasking, why would you 

want to? The other multi-tasking operating “9 

system is not now, nor is it planned to be, 

multi-user. It won’t even run multiple DOS appli- 
cations in multi-tasking mode. 

Now consider PC-MOS/386™ At the touch of a key, Z 
you can switch between up to 25 different tasks. And if you have 
workstations connected to a host, they get multi-tasking, too. 
Finally...a system that won't hold you back. 
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8, Security When you decide to 
implement either a network or a multi- 
user system, there’s a two-fold problem 
which must be solved: protecting 
your work from accidental misuse 
and securing it from intentional theft. 
PC-MOS/386™ solves both aspects of this problem. Password 
protected security allows you to assign file, directory, and task 
access to each user. Plus, files and records are locked using either 
PC-MOS’ proprietary system or NETBIOS emulation. 
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power...which makes PC-MOS/386™ a pt weapon to your 
competition. Imagine on-the-road salespeople being able to file 
call reports and access your latest inventory data. Picture execu- 
tives being able to access your corporate database from across 
the country, or around the world-giving them the information 
they need, when they need it. 

Visualize branch offices tapping time-critical data with 
nothing more than a modem and a workstation. Working at a 
home office in the evening or over the weekend suddenly gets 
awfully productive. And that makes good business sense. The 
kind of sense you can’t afford to be without. 

The Price...As you 


1 @ cvaluate operating systems, 
ask yourself if it’s reasons you’re consider- 
ing...or rhyme. Ask if you’re getting a 
system for tomorrow, or one that was made 
for yesterday, See if you're being forced to buy 
new hardware because of their software. 
And consider this. 

Only one operating system in the world can 
s give you the raw power, cae and woes that you 
demand. Its name is PC-MOS/386" <><. 
And it’s immediately availablein C% . | 
one, five and 25-user versions starting [» = +) 
at $195, iis) as 
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DEBUGGING WITH THE 80386 
(continued from page 20) 





useful to pop into your debugger and poke around. 
Conventionally, this is done with an external button that 
is linked to an option card that causes an NMI. The 
conventional method often has problems because so 
many option cards, including most popular multivideo 
cards, use NMIs. 

A protected mode debugger managing a virtual 8086 
environment can actually provide this breakout capabil- 
ity through a key sequence. The specific 80386 feature 
that is used to provide the breakout capability is called 
privilege levels. To understand privilege levels you must 
understand a little bit about 80386 protection. The 80386 
has four different protection levels, numbered level 0 
(highest privilege) through level 3 (lowest privilege). The 
four different privilege levels can be used for four layers 
of differing trust levels. 

In our debugger application, we need only two levels: 
level 0 and level 3. The debugger—as you'd expect— 
runs at level 0, while the virtual 8086 task runs at level 3. 
A program running at level 0 has complete access to all 
80386 protected features. A level 3 program in contrast, 
cannot access 80386 control registers and other 80386 
features. The ability to access I/O ports can be set (by the 
operating system or in this case by the protected debug- 
ger) at any level. 

If the privilege level is set to 3, the target program 
running in the virtual 8086 task has some additional 
restrictions. Certain instructions that have to do with 
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interrupts cause exceptions. These instructions are STI, 
CLI, LOCK, INT, PUSHF, POPF, and IRET. If you are an 
assembly-language programmer, you may have noticed 
that most of these instructions affect the processor 
interrupt flag. If the 80386 had two interrupt flags—one 
for the virtual machine and one for the native environ- 
ment—it would not be necessary to monitor these 
instructions. Because the 80386 does not keep track of 
the state of the interrupt flag separately for the virtual 
machine, the protected debugger must monitor all in- 
structions that cause a change in the state of the 
interrupt flag. 

By getting control when any of these instructions are 
executed by the target program, it is possible to “‘virtual- 
ize” the interrupt system. In the case of the breakout 
feature, the only concern is to handle the keyboard 
interrupt. When the target program disables interrupts, 
the debugger must continue to get keystroke interrupts. 
The keyboard interrupt must be handled by the debug- 
ger but cannot be passed through to the virtual 8086 
task. When keyboard interrupts occur, the protected 
debugger must monitor the keystrokes looking for a key 
sequence. If the sequence is found, the debugger is 
popped up. The tricky part is-making sure all keyboard 
activity meant for the target environment is passed 
through accurately. 

For hard-core systems types, it is worth mentioning 
that accesses to the interrupt controller mask register 
must be monitored as well. This is necessary in the 
cases in which interrupts are masked at the interrupt 
controller instead of at the processor interrupt flag. 
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DEBUGGING WITH THE 80386 
(continued from page 24) 





Memory Range Breakpoints 

The next debugging feature I’ll discuss is memory range 
breakpoints. Memory range breakpoints are especially 
useful when an errant program is overwriting a portion 
of memory. By trapping on the write, you can find the 
actual code that has gone astray. 

To implement memory range breakpoints, the pro- 
tected debugger uses an 80386 protected mode feature 
called paging. The paging mechanism in the 80386 was 
intended for providing demand-page virtual memory in 
a protected mode operating system. Memory is divided 
into 4K pages, and the operating system can mark each 
page as present or not present in the 80386 page tables. 
If a program is executing and it enters a page that is not 
present, an exception occurs. It is the responsibility of 
the operating system paging exception handler to load 
the actual contents of that page from a mass storage 
device. Paging takes advantage of the fact that most 
programs tend to spend most of their execution time in 
a few concentrated areas. 

Again, our debugger takes on the role of an operating 
system to manage the paging mechanism. When the 
user specifies a memory range, the debugger must first 
determine which pages the range covers. The debugger 
marks these pages not present in the 80386 page tables, 
and control is given back to the user program. If the user 
program accesses one of the pages marked not present, 
an exception occurs, and the debugger’s exception han- 
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4 Times Faster 


All MASM features (except 386 & CodeView support) 


*Generates smaller code! (no inserted NOP’s) 
*Automatically handles jumps out of range 
*Handles most of MASM’s phase errors 


*Simplified segmentation 


dler gets control at this point. The 80386 passes the 
exception handler the address that was accessed in 
control register 2 (CR2). In most cases the specified 
memory range does not start exactly on a 4K page 
boundary. When an exception occurs, the debugger 
must compare the actual address accessed with the 
actual range specified. If the access was within the 4K 
page but not within the specified range, control is given 
back to the target program. 

This boundary condition problem can cause perform- 
ance of the target program to degrade visibly in some 
instances, although in most cases the performance hit 
is negligible. One instance in which the performance 
drop is noticeable is if the top of the program's stack is 
in the page but not within the range. Even with this 
performance hit, range breakpoints using paging are still 
thousands of times faster than the software simulation 
technique that some debuggers use. 

A refinement of range breakpoints is possible. The 
80386 paging mechanism allows pages to be read- 
protected and write-protected, which gives the debug- 
ger the ability to allow memory range breakpoints on 
read, write, or read/write accesses. 

Range breakpoints occur immediately when using the 
80386 paging mechanism. The instruction that caused 
the breakpoint to occur is also restartable, so once the 
memory is present, the program can continue without 
missing an instruction. This gives the protected debug- 
ger the same advantage over hardware debuggers that it 
has with I/O breakpoints; breakpoints are not affected by 
the 80386 instruction pipelining. 
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DEBUGGING WITH THE 80386 
(continued from page 26) 


Breakpoint Registers 

Another 80386 feature that fits in with our protected 
debugger is the previously mentioned breakpoint regis- 
ters. Breakpoint registers were designed specifically for 
debugging purposes. They can be used in real-address 
mode and can be implemented very easily in a simple 
terminate-and-stay-resident (TSR) program or directly in 
a user program. 

The 80386 includes four breakpoint registers that can 
be used to set breakpoints for a byte, word, or double- 
word. These breakpoints can be on write, read/write, or 
execute accesses. The four breakpoint registers are 
named DRO, DR1, DR2, and DR3. Each breakpoint register 
holds the 32-bit linear address of the byte, word, or 
double-word of interest. The address must be on a word 
or double-word boundary for those respective data 
types. 

There are two additional registers: DR6 and DR7. DR6 
is a status register that is read after the breakpoint has 
occurred to determine which of the four breakpoints 
was triggered. DR7 is a control register that is written to 
specify the parameters for a particular debug register— 
for example, write-only on a double-word. DR7 also 
contains two enable bits that must be set to activate the 
breakpoint. 

When a breakpoint goes off, an 80386 exception occurs. 
The exception handler must read the status register to 
determine which of the four breakpoints was triggered. 

As with the I/O and range breakpoints, you can easily 
extend the capabilities of the debug registers by adding 
qualifying code to your exception handler. Other fea- 
tures that our Soft-ICE debugger provides by additional 
qualification code are breakpoint on read-only and com- 
parison with a data value. A read-only breakpoint can 
be implemented by decoding the instruction that caused 
the exception to determine if it is a memory read. If not, 
control is returned to the target program. 

Using breakpoint registers to perform breakpoints on 
execution has an advantage over the conventional INT 3 
approach. Software debuggers for the 80x86 place an 
INT 3 at the address of the desired execute breakpoint. 
An INT 3 is used because it is a special single-byte 
instruction (most interrupts are 2-byte instructions) in- 
cluded in all 80x86 processors specifically for providing 
breakpoint capability. The INT 3 approach has the 
disadvantage that it cannot work in ROM; the breakpoint 
registers work fine in ROM code. 


Triggering Your Favorite Software Debugger 
Optimally, the protected debugger should provide all 
the necessary debugging commands, such as dump, 
unassemble, modify, single-step, display registers, and 
so on. Many people, however, are addicted to their 
favorite language-specific debugger. For these people, it 
would be nice to extend the capabilities of their existing 
debugger by adding the features that are possible with 
the protected debugger. This is possible. The conven- 
tional debugger runs in the 8086 virtual machine and 
the protected debugger runs in protected mode. The 
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DOS environment is still affected by your conventional 
software debugger, but you can add additional break- 
point capability, such as breakpoint on memory range 
or I/O ports. 

Our Soft-ICE debugger provides both methods. For 
users who need a complete systems debugger, we 
provide all the necessary debugging commands. For 
those who wish to extend the capability of their existing 
software debuggers, we have a pop-up window that 
allows them to set sophisticated breakpoints that will 
trigger their software debugger. 

Triggering the conventional software debugger is pos- 
sible by understanding a little about the way most 80x86 
software debuggers work. Most software debuggers use 
the INT 3 approach described earlier to provide break- 
points on execution. They also use the 80x86 INT 1 
single-step mechanism. All members of the 8086 line 
have the capability to single-step the next instruction. 
The debugger must set a special processor flag called 
the trap flag, and when the trap flag is set, an INT 1 
occurs after every instruction is executed. 

By relying on the INT 1 vector or the INT 3 vector 
pointing to the conventional debugger's breakpoint- 
handling routines, we can generate INT1s or INT 3s to 
wake up a conventional debugger. Most debuggers 
handle unsolicited INT 1s or INT 3s beautifully; how- 
ever, a few will not. The third approach uses NMI. Most 
debuggers have a method of handling unsolicited break- 
points through the NMI mechanism—for example, Code- 
View provides this with a command-line switch. They 
provide this capability to break out of hung programs 
when the user presses an external button. This button 
is wired through the PC bus to the NMI pin. By taking 
advantage of these three conventional breakpoint mecha- 
nisms, we can wake up almost any conventional debug- 
ger. 

A side effect of waking up a debugger unknowingly is 
a problem with reentrancy. Many debuggers enable 
interrupts or use DOS for I/O. If you wake the debugger 
up while the processor is in an interrupt routine, or 
within MS-DOS or the ROM BIOS, the debugger will fail. 
Waking up a nonreentrant debugger is still useful for 
application-level debugging. Many debuggers are mostly 
reentrant, and you can wake these up at any time; 
Periscope I and II are examples of these. 


Conclusion ; 

To build a complete protected debugger requires several 
additional components. These include “virtualizing” the 
video display system to save and restore the screen at 
any time and likewise the keyboard so users can debug 
keyboard device drivers. The purpose of this article was 
to describe debugging features, so I haven't gone into 
those details. By creatively applying 80386 protected 
mode operating system features in a real-address mode 
debugger, you can provide most of the features found in 
a hardware-assisted debugger with the convenience of a 
software debugger. 
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ARTICLES 


A Serial Protocol 
Analyzer Program 


his article describes the im- 
FBP eiementation of an RS-232 

serial protocol analyzer (SPA) 
program hosted on an IBM PC com- 
puter. It utilizes the multitasking 
kernel I presented in the July 1987 
issue of DDJ. The software provided 
in this article converts a PC into a 
tool that can be used to monitor 
most RS-232 connections. 

The program was developed as 
an alternative to spending $5,000— 
20,000 on a dedicated serial protocol 
analyzer device. Don’t misunder- 
stand, this program (in its present 
form) doesn’t have half the features 
and functions provided by a dedi- 
cated protocol tester, but it performs 
very well when simply displaying 
RS-232 data—the function a dedi- 
cated analyzer is used for 95 per- 
cent of the time. What's even better 
is that the SPA software is available, 
so you can tailor it to your specific 
applications. 

This program will find use in 
many software development labs, 


Craig A. Lindley, 6 Sutherland PL, 
Manitou Springs, CO 80829. Craig has 
been working with real-time operat- 
ing systems for many years. He has 
worked at the Jet Propulsion Labora- 
tory on the implementation of part 
of the real-time system to be used 
on the upcoming Galileo spacecraft 
and is currently employed at Rolm 
Corp. as a software engineer involved 
in real-time telephony control. 
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Debugging the bit stream 


with Turbo Pascal 


by Craig A. Lindley 


computer/data-processing centers, 
and just about anywhere else that 
RS-232 devices are used. In this day 
and age of corporate frugality, 
buying or borrowing an IBM PC to 
run an application of this type is 
probably a lot easier than trying to 
justify the cost of a dedicated proto- 
col analyzer. Also, you can’t run 
Lotus 1-2-3 or word-processing soft- 
ware on your dedicated protocol ana- 
lyzer when it isn’t being used for its 
designed function. 


What Does an SPA Do? 

An SPA provides a visual picture of 
data flowing between two serial de- 
vices connected via an RS-232 inter- 
face. In addition, it provides a 
method of monitoring the RS-232 
handshake lines (RTS, CTS, DTR, 
DSR, and so on) in a manner not 
unlike the two-color LED arrange- 
ment used on RS-232 breakout 
boxes. Figuring out what a serial 
interface is doing (or is not doing) 
without a device of this sort is ex- 
tremely difficult. 

The SPA will find use in two major 
areas—first, in software labs to assist 
in the development of RS-232 data 
protocols for new products or de- 
vices, and second, in data communi- 
cation users environments in figur- 
ing out why two supposedly com- 
patible serial devices are not talking 
to each other. I'll give an example of 
each application. — 

Consider the development of a 


terminal emulator program. The SPA 
could be used to verify that key 
codes programmed on a special func- 
tion key were indeed being sent out 
of the serial port when the special 
function key was pressed. The SPA 
could also be used to verify that the 
terminal program could really gener- 
ate a break condition on its port 
lines. Finally, the SPA could be used 
to verify the terminal emulator’s im- 
plementation of the Xmodem file 
transfer protocol. 

In a data communications envi- 
ronment, consider the case of a 
serial printer loosing some of the 
characters sent to it. The SPA could 
be used to determine that the 
printer was sending the XOFF soft- 
ware handshake command but that 
the source or the serial data was not 
responding to it by stopping its trans- 
mission of data. 

These are two of the many possi- 
ble applications of the SPA program. 
In a general sense, the SPA can take 
the guesswork out of serial device 
interfacing and can be considered a 
serial interface debugger. Any aids 
in the debugging process will equate 
to increased productivity and re- 
duced frustration. 


What Is Required 

The following is the minimum equip- 
ment required for use of the SPA 
program: 


1. An IBM PC, PC/XT, or PC AT (or 


Dr. Dobb’s Journal, February 1988 


compatible) with at least 256K RAM. 
An AT is required for data rates 
greater than 4,800 baud. 

2. Two serial ports: COM1 config- 
ured at address 3F8H using inter- 
rupt IRO4 and COM2 configured at 
address 2F8H using interrupt IRO3. 
3. The SPA executable program 
(SPA.COM). 


If you would like to experiment 
with the SPA code, these additional 
items are required: 


1. 256K of additional memory for 
compiling the program in memory 
and executing it. 
2. Turbo Pascal, Version 3.0 or later, 
for the IBM PC. 
3. The following source code files: 

@ SPA.PAS (Listing One, page 44)— 
the main program file 

@MENU.PAS (Listing Two, page 
66)—the menuing subsystem 

@ SERIAL.PAS (Listing Three, page 
80)—the serial port handlers 

@ MULTI.PAS—the multitasking 
kernel presented in the July 1987 
issue of DDJ, with slight modifica- 
tion. 


Personally, I think the SPA is a 
useful program. In addition, if you 
examine the software components 
that make up the SPA, you'll find the 
following components are useful in 
themselves: 


1. A generalized multitasking kernel 
written in Turbo Pascal. 

2. A generalized 1-2-3-like menuing 
system that can be converted for 
use in another application simply 
by changing its database. 

3. A BlIOS-independent, interrupt- 
driven, serial interface package sup- 
porting both the COM1 and COM2 
ports. This, too, is written in Turbo 
Pascal. 


The moral of this story is, if you 
can't use the whole program, maybe 
you can use the pieces. 


Connecting the SPA for Use 
Two methods exist for connecting 
the SPA to the RS-232 interface to be 
monitored. The first I call the pas- 
sive monitoring connection and is 
shown in Figure 1, right. 

This diagram shows the minimum 
connections necessary to use the 
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SPA to monitor an RS-232 connec- 
tion. In this case the SFA does not 
pass the data through. It merely 
monitors the data sent between 
both serial devices. 

The additional monitor lines can 
be connected to any of the serial 
lines you wish to monitor on the 
SPAs’ screen. The signal connected 
to: pin 5 will show up as CTS; pin 6 


On Dat WD — 


will show up as DSR; pin 8 will 
show up as CD; pin 22 will show up 
as RI. With this connection method 
the PC, which is hosting the SPA 
program, does not sit between the 
two ends of the RS-232 cable. The 
two endpoint serial devices are con- 
nected just as they would be with- 
out the SPA attached. The SPA is 
effectively connected in parallel to 


To 
serial 
devices 
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Figure 1: The passive monitor connection 
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Figure 2: Pass through monitoring 
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How many 
@ programmers does 
it take to maintain a 
MAKE dependency file? 








NONE! /f you 
@ use VersiMAKE™ 


VersiMAKE™ is a full-featured 
MAKE utility that includes: 


mM Dependency Generation 
Derives your system’s dependencies, 
through analysis of its C and MASM 
source files. Say goodbye to manual 
maintenance of MAKE dependency files! 
H Wild Card File Name Matching 
Analyzes an entire collection of source 
files with a single statement. 

@ Nested Inciude File 

Handles standard C and MASM “‘include”’ 
conventions, and the INCLUDE environ- 
ment variable. 

@ Powerful Macro Facilities 
Built-in macros, user-defined macros, 
and environment variables. 

@ Analytical Reports 

Shows the entire Include file hierarchy 
for each source file analyzed, and all of 
the parent source files for each Include file. 


How many 
@ programmers does 
it take to trace a 
symbol thru your system? 


ONE! /f you 
@ use VersiCREF™ 





VersiCREF™ is a unique utility 
that creates a Master Cross- 
Reference of your entire system. 


@ Multi-Lingual 
Handles C, assembler, or both. 


@ Flexible 

File names with line numbers, or file 
names alone. Global and local symbols, 
or globals alone. 

@ Powerful 

Easily handles systems containing 100 
source files or more. 


VersiMAKE™ $125 
VersiCREF'™ $75 
Both $150 


(Outside U.S., add $5 for shipping 
and handling) 


800-334-4096 
(In NJ, 609-871-0202) 
MC/VISA/AMEX accepted 


SUMMIT INFORMATION 
SYSTEMS, INC. 
73 East Lane, Willingboro, NJ 08046 


CIRCLE NO. 116 ON READER SERVICE CARD 
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PROTOCOL ANALYZER 
(continued from page 31) 


the serial data path. The data being 
transmitted by the devices on both 
ends of the serial interface is routed 
to the receive data inputs of COM 
ports 1 and 2 of the SPA’s PC. Also, 
any of the four available inputs to 
the COM ports (CTS, DSR, CD, or RI) 
can be tied to any of the lines of the 
serial interface being monitored to 
allow the SPA to display their states 
visually to the user. 

The second connection method I 
call the pass through connection. 
Figure 2, page 31, shows the cabling 


|In Fifo: 0O% OutFifo 0% | 





====s=e=== Serial Protocol Analyzer Ver: 


required for this connection 
method. With this connection, the 
SPA program sits between both 
serial devices. All data and hand- 
shake line states generated and re- 
ceived by both serial endpoint de- 
vices pass through (and can there- 
fore be processed by) the SPA pro- 
gram. This is the mode for which 
the current SPA software is opti- 
mized. It allows the maximum flexi- 
bility for future SPA program func- 
tionality. 

The CD and RI lines may require 
additional connections if the serial 
devices being monitored require 
that these signals are actively driven. 


1.0 =e=s=s====== COM2 = 


|In Fifo: 0% Out Fifo: 0% | 


Y 
|Stat- BRK:- FE:- PE:- OR:-|Craig Lindley|Stat- BRK:- FE:~ PE:~ OR:-| 


|In - CD:M RI:S DSR:S CTS:S|Display 
3% {}Out - DTR:S 


jOut - DTR:S RTS:S | Fifo: 


|In - CD:M RI:S DSR:S CTS:S| 
RTS:S | 


Figure 3: The main SPA display screen 


Interrupt 
service 
routine 


OutputCOM1 Data 
task 


Interrupt 
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routine 


OutputCOM2Data 
task 
ProcessKeys 
task 


DisplayCOMData 


MoveCOM2Data 
task 


Display 


- MoveCOM1Data “a 


task 


Timer 
task 


task 





Figure 4: The block diagram of the SPA program. 
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The PC serial hardware does not 
have the driver outputs necessary 
to drive these signals as it does the 
RTS and DTS signals. The CD and 
RI lines from one side could be 


connected to the same signal pins |~ 


on the other side. 


How to Use the SPA 

After connecting the SPA’s PC to the 
serial devices using one of the two 
connection methods, you must exe- 
cute the SPA program. The SPA pro- 
gram is normally compiled into an 
executable .COM ffile called 
SPA.COM. To execute it just type 
SPA at the DOS prompt. 

The first thing you'll notice is that 
the SPA program verifies the pres- 
ence of two serial ports (COM1 and 
COM2 at the proper addresses). 
Unless two serial ports are found, 
the program will halt with an error 
message. 

If the hardware verification is suc- 
cessful, the operator is presented 
with the main display _ screen, 
similiar to that shown in Figure 3, 
page 32. As you can see, this screen 
presents a lot of information about 
both the COM1 and the COM2 ports. 
I'll now describe each item: 


In Fifo, Out Fifo, and Display Fifo: 
These numbers, expressed in per- 
centages, indicate how full the vari- 
ous FIFOs used by the SPA program 
are. See the block diagram in Figure 
4, page 32, for an explanation of the 
function of each of these FIFOs. 
Note: These percentages are not 
updated in real time, only every half 
second. They are shown to provide 
a feel for how well the SPA is proc- 
essing the serial data. It is quite 
possible, however, to have a FIFO 
overflow occur even though the num- 
bers suggest there is still consider- 
able room in the FIFO. 
Stat—BRK, FE, PE, and OR: These 
are the various status and error con- 
ditions of the COM ports in the PC. 
BRK indicates a break condition on 
the line, FE indicates a framing 
error, PE indicates a parity error, 
and OR indicates an overrun error 
has occurred. See the IBM technical 
reference manual for an explanation 
of these conditions. The no-error 
condition is indicated with a dash 
whereas the error condition is indi- 
cated by an E or B in the case of a 
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break. 

In—CD, RI, DSR, and CTS: These are 
the various input lines into the COM 
ports. Their states are continually 
monitored by the SPA program, and 
any changes are shown on the dis- 
play. Their states are either M for 
marking or S for spacing. 

Out—DTR and RTS: These are the 
two output lines from the COM 
ports. Their states are also either M 
for marking or S for spacing. Note: 
The SPA program routes what is 
received on one COM port’s DSR 
line to the other COM port's DTR 
line, effectivley passing the state 
through the PC. The same is true of 


the CTS and RTS lines. This hand- 
shake line pass through happens in 
both directions. 


The information line at the 
bottom of the display informs the 
user that: 


1. If the Esc key is pressed, the 
menu system will be entered. The 
highest-level menu is shown in 
Figure 5, page 34. 

2. If the space bar is pressed while 
data is being displayed, the display 
will pause until the Enter key is 
pressed to restart it. 

3. If COM1 data is being displayed 


cs 
has three features 
professional 
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A SMART 
CARD EXTENDER 


Serial Protocol Analyzer Menu 
-- Main Menu Selection -- 


Parameters Display Trigger Format Control End 


Exit Analyzer Menus 





Figure &: Main menu of the SPA program 


Main Menu - Transition Chars = QPDTFCE 
(0,0,0) 


| 
Quit Parameters Display Trigger Format Control End 
(3,0,0} (2,909,090) (3,0,0) (4,0,0) (5,606,090) (6,0,0) (7,0,0) 
ccode=1 Parameters - Transition Chars = QBSWP 
(2,0,0) 


INTRODUCING: 


EASY ON 
A smart card extender for 
PC/XT/AT compatibles 


| 
Quit Baud Rate Stop Bits Wrd Length Parity 
{2.1 0) {22,6} (2,353,090) (2,4,0) (2,5,0) 
Baud Rate - Transition Chars = Q361249 
(2.250) 


Quit 300 600 1200 2400 4800 9600 
(2,2,4} (2,2,2) (2.2.3) (2,24) (2,2,5) (2,236) (2.2.4) 
: ccode=2 ccode=3 ccode=4 ccode=5 ccode=6 ccode=7 
Stop Bits - Transition Chars = Qi2 
(2,3,0}) 


$165 — PC/XT 
$1950 — AT 


| 
Quit 1 2 
(2,3.1) (2,3,2) (2,3,3) 
: ccode=8 ccode=9 


e Allows card insertion and 
extraction without power 
on/off cycles 

e Saves time by eliminating DOS 


re-boots 
« Reduces wear and tear on Figure 6: The A tree menu structure (partial) 


hard disk drives 
e Extends host interface for 2. 
hardware and software 


development and test 
e A single switch controls the 





menu__entry = RECORD 


: title —ltem or submenu name. This string with a maximum length of ten 
connection of all signals to and characters is displayed on the selector line and can be selected by 
from the computer bus pressing a key corresponding to the first character of its name. 

e Patent pending desc —Description of item or submenu up to 40 characters in length. Explanatory 
text describing the item or submenu. 
chars -—A string of upper case characters which can be used to select any item 


30 DAY NO RISK on this menu level. This string usually contains the first character of each 
EVALUATION items title. 
index —This entry contains the length of the “chars” string above. 
ccode —Only non zero at A tree leaf nodes. It is the command code to be 
processed by the procedure ProcessCmd which is associated with this 
menu entry. 


APPLIED DATA SYSTEMS 
9811 Mallard Dr. Suite 203 


Laurel, MD 20708 END: 


For more information call 


1-800-541-2003 


CIRCLE NO. 117 ON READER SERVICE CARD 





Figure 7: A Menu Entry Record 
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PROTOCOL ANALYZER 
(continued from page 34) 


(the data received at the COM1 port), 
it will be shown in normal video. If 
COM2 data is being displayed, it will 
be in reverse video to allow an easy 
visual distinction. 


To set up the SPA program for 
use, you must enter the menu 
system using the Esc key. Normally, 
the setup consists of selecting the 
proper baud rate, parity, and word 
length of the serial data stream to 
be monitored. The defaults chosen 
for all other setup parameters are 
adequate for an initial data display. 
Once the setup is complete, the end- 
point serial devices should be en- 
abled to start data transmission. If 
all is well, the data being passed 
back and forth between the serial 
devices should be shown on the 
SPA’s display. 

The menu system has the capabil- 
ity of altering the operation of the 
SPA program. In all, there are 35 
possible alterable parameters that de- 
termine how the SPA operates. The 
procedure ProcessCmd in the file 
SPA.PAS (Listing One) shows exactly 
how each of the menu options is 
processed. A quick trip through the 
menuing system will acquaint you 
with flexibility of the SPA program. 
Note that data will still be acquired 
and displayed by the SPA program 
while you are using the menus. That 
is the beauty of a multitasking 
system. 

The more important features of 
the menu system are: 


1. Under the Parameters menu, you 
set the baud rate, parity, and 
number of stop bits with which the 
data should be interpreted. The pro- 
gram supports rates from 300 to 
9,600; five through eight data bits; 
odd, even, or no parity; and one or 
two stop bits. If the serial parame- 
ters are set incorrectly, the data dis- 
played on the SPA’s screen will be 
garbage. 

2. Under the Display menu, you set 
whether the data from COM1, 
COM2, or both is displayed on the 
screen. 

3. Under the Trigger menu, you set 
up the SPA’s triggering capability. 
Here you input the channel (COM1 
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or COM2) to trigger from, the single- 
byte trigger data pattern, and the 
trigger mode (display data until trig- 
ger or display data after trigger). You 
can also stop (wait for) the trigger in 
this submenu. Note: After the trigger 
parameters are set, the trigger must 
be enabled before it goes into effect. 
4. The Format submenu is where 
the format of the displayed data is 
set. The options are: 


@ ASCII data without handshake 


(default) 

@ASCII data with handshake 
(handshake shown in hex) 

® Hex data without handshake 

@® Hex data with handshake 


When data is displayed with the 
handshake option, the port input 
lines that were acquired when the 
data was acquired and certain COM 
port error conditions will be dis- 
played. The information is bit en- 
coded into the displayed hex byte 
as shown in Table 1, page 37. 

The final option in the Format 
menu is simply called SPACE. This 
is a toggle that determines whether 
the data displayed on the screen is 
separated or not—in other words, 
whether a space will be inserted 
between each displayed data item. 
If a space is being inserted and this 
menu option is selected, the spac- 


Speed. 






pointers. 
*Time is negligible. 





Fast Execution Speed. 


Microsoft® C 4.0 Microsoft C 5.0 
Sieve (25 iterations) at 5 
Loop 11.0 0.0* 
Float 19.9 0.1 
Dhrystone 22.8 19.1 
route: 14.2 7.4 
* New optimizations generate the fastest code: 


— Inline code generation. NEW! 
—Loop optimizations: NEW! 
— Loop invariant expression removal. NEW! 
— Automatic register allocation of variables. NEW! 
— Elimination of common sub expressions. 
— Improved constant folding and value propagation. 
- Fine tune your programs for even greater speed: 
— Coding techniques for writing the fastest possible 
programs are included in the documentation. NEW! 
—Segment Allocation Control: 
—Group functions into the same segment to get faster 
NEAR calls. NEW 
— Specify which segments receive variables to yield 
faster NEAR references. NEW! 
— Uses register variable declarations. 
— Mix memory models using NEAR, FAR & HUGE 


! 


Microsoft C.5.0 
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How Soft-ICE works 


Soft-ICE unleashes the power of the 80386 to surround your program in a 
virtual machine. This gives you complete control of the DOS environment. 
Soft-ICE uses 80386 protected mode features, such as paging, I/O privilege 
level, and break point registers, to add real-time hardware-level breakpoints to 
your existing DOS debugger. To use Soft-ICE you simply pop the Soft-ICE 
window up through a key sequence, set your hard break points, then return to 
your soft debugger. As the target program is executing, Soft-ICE recognizes 
when the breakpoint conditions have been reached and gives control back to 
your soft debugger. And this is all done at full 80386 speed! Soft-ICE can 
also be used in stand-alone mode. This comes in handy if you are debugging 
loadable device drivers, interrupt handlers, or terminate and stay resident 
programs. All of the standard debugging features are available to help you 
find the most difficult systems problems. 


"Since Soft-ICE doesn’t take up any of my facie | I have it in my AUTOEXEC.BAT to load every day... It has saved 
r 


me at least one month’s time on my latest device driver program." Peter Ricker, President of Maverick Software 

















PROTOCOL ANALYZER 
(continued from page 35) 


ing will be stopped; the reverse is 
also true. 

5. The Control submenu contains 
several commands that control the 
operation of the SPA program. Data 
acquisition can be stopped and 
started; the display can be cleared; 
and finally, the SPA program can be 
reset to its power-on defaults. 

6. The Quit menu option returns 
you to the main SPA display screen, 
and the End option ends the opera- 
tion of the SPA program completely 
and returns control to DOS. Note: 
Selecting Quit from any submenu 
will always bring you back up one 
menu level. 


The complete hierarchical menu 
structure is too big to list. You can 
look at the procedure /Init__Menu in 
the file MENU.PAS for more informa- 
tion. Also, a short textual message is 
displayed with each possible menu 
selection. This is a limited form of 
context-sensitive help to guide you 
through the menuing system with- 
out your having to consult any docu- 
mentation. 


The SPA Program's 
Architecture 

Now that you understand how to 
use the SPA program, I'll spend a 
few minutes discussing the underly- 
ing technical aspects of the pro- 
gram’s operation. For the following 
discussion, please refer to Figure 4. 

As shown in this block diagram, 
the SPA program is made up of 
seven relatively independent tasks, 
most of which are bound to a FIFO. 
In summary, the tasks perform the 
following: 

The tasks MoveCOM1Data and 
MoveCOM2Data perform the same 
function on different FIFOs for dif- 
ferent COM ports. These tasks per- 
form three basic functions. First, 
they move serial data and hand- 
shake information from their respec- 
tive input FIFO to the opposite 
output FIFO. This makes the serial 
data path through the PC. Second, 
the serial data is tagged with a 
source identifier (either from COM1 
or COM2), and if the display data 
flag is set, the data is moved into the 
display FIFO. Finally, code in these 
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tasks provides the data triggering 
function. 

The tasks OutputCOM1Data and 
OutputCOM2Data again are identical 
in function but access different 
FIFOs. They check to see whether 
there is data in their respective 


output FIFOs, and if so they send it 
out the COM port. 

The task DisplayCOMData removes 
entries from the display FIFO, for- 
mats them according to the SPA 
user’s specification, and displays 
them on the SPA’s display. 


Bit Numbers 


5 4 


DSR CIS GRK FE FE 





3 2 1 0 
OR 


Table 1: Correspondence between data bit encoded and displayed hex byte 


Speed. 


Fast Compilation. 
Fast Prototyping. 


Microsoft C Version 5.0 includes QuickC™ which 
lets you edit, compile, debug, and execute in an 
integrated environment. It’s ideal for prototyping. 
-In-memory compilation at 10,000 lines/ 


minute. NEW! 


¢ Built-in editor with parentheses, bracket and 


brace matching. 


- Use the integrated debugger to animate through 
your program, add watch variables and set 
dynamic breakpoints. NEW! 

- MAKE file is automatically generated for you. 
Simply indicate the modules you want to use, 
then MAKE recompiles and links only those 
modules that have changed. NEW! 

«Full C 5.0 compatibility: 

— Completely source and object code compatible. 
— Emits CodeView®-supported executables. 
— Identical compile/link command line switches. 
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MASTER*KEY will guide you 
1. 


Help you learn assembly language, if you desire. 
2. 


3. 


turn this 
into this! 


MASTER*KEY 
No Other Product Comes Close! 


An EXPERT may not know the solution, but always 
knows where to find it. 


MASTER«KEY HELPS ANYONE solve those 
confusing and frustrating software puzzles more 
rapidly and easily than any other software available, 
at any cost! It gives you know-how within hours that 
may otherwise take years of experience. Create a 
new program from an old one. DON’T REINVENT 
THE WHEEL! 


MASTER+KEY - Smart! 

MASTER<«KEY is an intelligent self-documenting 
MS-DOS reverse assembler. Its sophisticated 
procedures swiftly race through massive and baffling 
object code files to effortlessly discover potential 
trouble spots. 


MASTER+KEY - Educational! 

YOU DON’T NEED TO KNOW ASSEMBLY 
LANGUAGE! MASTER<sKEY will take any program 
from your IBM-compatible computer and return fully- 
documented, easily-understood assembly language 
source code (Microsoft MASM 4.0 compatible). 


MASTER*KEY - Easy To Use! 

MASTER+«KEY works both automatically from the 
DOS command line or interactively from menus 
similar to Lotus Corporation’s 1-2-3 or Symphony. 
No need to remember any new commands or con- 
tinually refer to a manual. Use it immediately! 


Minimum System Requirements: 
256K + 8088/8086/80186/80286/80386 PC 
MS-DOS or PC-DOS 2.0 + 
One 360K DSDD Floppy Drive (IBM PC Format) 


MS-DOS is a trademark of Microsoft. 
PC-DOS is a trademark of IBM. 





Discover how any program runs or why 
it doesn't. 


Alter or remove unwanted object code from 


any program. 


Incorporate routines from compiled programs 


into other assembly language, Basic, C, or 
Pascal programs. 


Dealer/Distributor Inquiries Welcome 


Sharpe Systems Corporation 
2320 E Street, Dept. 44, La Verne, CA 91750 714-596-0070 


C:>DEBUG PROGRAN 
-Di00 136 





- COM 


8848:0130 CD 21 CD 20 58 EB 2F 
-Q 


8848:0100 EB 18 49 GE 63 6F 72 72-65 63 74 20 44 4F 53 20 k.Incorrect DOS 
8848:0110 76 65 72 73 69 GF GE OD-OA 24 50 B4 30 CD 21 86 version..®P40N!. 
8848:0120 EO 3D 36 01 72 OS 3D OA-02 76 O9 BA O02 O1 B4 O9 ‘s6.r.#..v.:..4. 












NIM Xk/ O 









HOO100: JMP Short HOO11A 300100 EB18 oh 
O : DB “Incorrect DOS version" 300102 496E636F727265 O 
DB ODh 300117 
DB OAh 300118 
O DB “s" 300119 24 O 
HOO11A: PUSH AX 3;0011A SO P 
O MOV AH, 30h 3;0011B B430 _o O 
INT 2ih 3i-DOS_Ver_Number 3;0011D CD21 ae 
XCHG AH, AL 30011F 86E0 a 
CMP AX,0136h 300121 3D3601 =6_ 
© JB HOO12B .% aaa) Ss ek 300124 7205 = O 
CMP AX,O20Ah 300126 3DOA02 ie 
JBE HOO134 » e 00129 7609 vi: 
O HOO12B: NOV DX,0102h 3;0012B BAO201 wird O 
MOV AH,O9h ;0012E B409 3 
INT 2ih 31-Display_String 300130 CD21 23 
INT 20h ;TERM_normally:20h 300132 CD20 ha 
O Re Oo a te Re eth tee iy S eh mes O 
HOO134: POP AX 300134 58 Xx 
IMP Short HOO1i66 300135 EB2F J 
O O 
MASTER*KEY XREF - PROGRAN.XRF Page i 
O O 
0102h : 121 2F5 301 320 
O20Ah 3 126 
O3CBh : 1i2B 
O 1-Display_String rs 130 359i 619 = = ==“ O 
1-DOS Ver Number : 11D 2 me agg ‘ 
#00100 por” iee _ NOTE: The cross-reference is by 
O HOO11A : 100 811A a nemory loca’ O 
HOO12B : 124 12B 
HOO134 : 129 134 
HOO166 : 135 
O TERM_normally:20h : 132 _— Oo 
O O 


step by step to: 


9. Make software more compatible with your 
computer. Be certain a questionable program 
won't damage your system BEFORE you run it. 

6. Modify software to operate with other 
versions of DOS. 

7. Customize your COMMAND.COM or other 
executable program directly or by reassem- 
bling your altered MASTER«KEY source code. 


MASTER *KEY should not be confused with any public 
domain or share ware software that may have a 
similar name or be a similar product. 
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(not copy protected) 


Phone orders accepted on MC or VISA 


Order Now! _ 382.45 (includes $2.50 shipping) 


$87.65 in California (includes tax & 


Just $799 shipping) C.0.D. orders add $2.00 


(714) 596-0070 


Please send MASTER*« KEY! 


Send checks to: 


Sharpe Systems Corporation 
2320 E Street, Dept. 44, La Verne, CA 91750 





Name 
Address 
City State Zip 





PROTOCOL ANALYZER 
(continued from page 37) 


The Timer task runs every half 
second. Its purpose is to update the 
information on the main SPA dis- 
play screen. Specifically, it updates 
the handshake information and the 
buffer usage information displayed 
to the user. 

The final task, ProcessKeysTask, 
monitors the SPA’s keyboard and 
processes all user keystrokes. The 
menuing system is invoked via this 
task. 


The Menuing System 

As previously mentioned, a hierar- 
chical series of menus is used to 
control the operation of the SPA pro- 
gram. The menuing system is mod- 
eled after Lotus 1-2-3 because of its 
ease of use and the appropriateness 
of its operation. A menu item or 
submenu is selected by using the 
cursor arrow keys to place the re- 
verse-video selector box over the de- 
sired item and pressing Enter or by 
typing the first character of the 
item’s name. The user of the SPA 
program can move through almost 
the entire menuing sustem by press- 
ing only single keys. In only one 
instance—the selection of a trigger 
byte—is the use of more than one 
key necessary. 

Five procedures from the file 
MENU.PAS (DisplayMenu, ProcessCr, 
ProcessMenu, ProcessCmd, and 
DoMenu) are used in conjunction 
with a large data structure to pro- 
vide the Lotus 1-2-3-like menuing 
system. These procedures imple- 
ment an A-tree walk through the 
menu data structure. For more infor- 
mation on the A (or Awkward) tree 
structure, see the article “Indexing 
Open Ended Tree Structures” by 
John Snyder in the May 1984 issue 
of Byte magazine. 

The A-tree menu data structure is 
rather inefficiently, but simply, real- 
ized in the SPA program using a 
three-dimensional array of menu 
entry records. A menu entry record 
is used for each item in the entire 
menu. Figure 6, page 34, shows a 
portion of the menu structure. Ap- 
proximately 24K of data is required 
to support the menuing system as 
the array of menu entry records is 
very sparse. 
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The numbers in () are the array 
indices of the menu entry record 
corresponding to this menu item or 
submenu. All items with an assigned 
ccode are leaf or terminal nodes of 
the A tree. These codes are proc- 
essed by the procedure ProcessCdm. 
Transition characters are _ those 
which cause movement to a differ- 
ent menu level. Typically, they are 
the first character of each menu 
item. The complete A tree menu 
structure for the SPA program is 
built by the procedure Init__Menu. 
Figure 7, page 34, shows a detailed 
breakdown of the menu _ entry 
record used in the A-tree structure. 


The following keys have special 
significance while using the menus. 
They are: 


Enter—Selects the currently high- 
lighted menu item. If the item is a 
submenu, the submenu is displayed 
with its own selectable options. If 
the item is a leaf node of the tree, it 
returns a unique command code 
(ccode) specifying an action to be 
performed. 

Cursor arrow keys—Move the high- 
lighted, reverse-video selector box 
through the items in a menu. Full 
selection wrapping is supported. 
Esc—Terminates the menuing sys- 












¢ Debug larger programs: 


support. NEW! 


program execution: 


to your hardware: 


program executes. 


Fast Debugging. 


Microsoft C Version 5.0 includes Microsoft CodeView, 
our source-level windowing debugger that lets you debug 
more quickly and thoroughly than ever before. 


— Debug through overlays created by the 
Microsoft overlay linker. NEW! 
—Expanded Memory Specification (EMS) 


Fast debugging through precise control of your 


— Access source level and symbolic debug information 
from your Microsoft C, FORTRAN, and Macro 
Assembler programs. NEW! 

— View your source code and assembly simultaneously. 

— Watch the value of variables change as you execute. 

—Set conditional breakpoints. 

— Animate or single step through your program. 

¢ CodeView brings you as close as you’ve ever been 


— Swap between your code and output screens. 
— Watch your registers and flags change as your ~~ 


All benchmarks run on an IBM® Personal System/2™ 


Fervour ¢ 5.0 pili packet cal 
(800) 426-9400. — 


IF (206) 882-8088. In Canada 16) 673-7638. 
Oe ckC 
is a trademark of Mocrosoft Corporation: ISM is a regeleret tradetnaric and 
Personal ee Machines Cor 
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dBASE Programmers 


You need it! 


CR You can handle it! 
(7 2dB2c is here now! 


dB2c Offers: 

¢ Version 2.0 complete with 
Translator and File 
Handlers. 

« Extensive implementation 
of dBASE Ill+ with over 200 
functions and commands in 
C source code. 

¢ Contains our own File 
Handlers plus interfaces for 
Lattice’s dBC and Faircom's 
c-tree. 

¢ Supports screen I/O with 
ANSI.SYS or fast assembler 
routines. 

¢ Support for Microsoft, 
Lattice and Turbo C 
compilers. 

¢ Tutor features of trans!ation 
combined with familiar 
syntax of the library eases 
the transition to 'C’. 

¢ One version supports MS- 
DOS, Xenix, Unix, OS-9 
ard Concurrent DOS. 


are you 
ready? 


olliZ~< 





Toolkit $299 
=> Call or Write: 
Cae ae SOFTWARE 
CONNECTION, INC. 


POB 712, Ely, MN 55731 
(218) 365-5097 





DAVID J. 
MARSH 
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PROTOCOL ANALYZER 
(continued from page 39) 


tem and returns to the main SPA 
display screen. 
Home—Moves the selector to the 
first menu entry. 

End—Moves the selector to the 
last menu entry. 


Hopefully, the operation of the 
menuing system will be discernable 
from the commented listings. Possi- 
bly a future article could be written 
to discuss the menus in detail if 
interest warrants it. 


Changes to the 

Multitasking Kernel 

I've made two changes to the kernel 
presented in the July issue of DDJ to 
augment its capabilities for use with 
the SPA program. They are: 


1. The constant task__stack__size 
has been increased to 1,000 bytes. 
This was necessary because of pro- 
cedure nesting depths, the use of 
interrupts, and Turbo Pascal's use 
of BIOS calls. Each task is assigned 
a stack size of 1,000 when forked. 
The seven tasks utilized for the SPA 
program consume approximately 7K 
of memory for their stacks. 

2. Substantial portions of the proce- 
dures Yield and Wait have been re- 
coded into assembly language. This 
minimizes the task-switching over- 
head experienced by the CPU. List- 
ing Four, page 80, shows the assem- 
bly-language recoding. This change 
was not absolutely necessary for the 
operation of the SPA, but it seemed 
to help the performance of the data 
display when operating above 2,400 
baud. By way of comparison, the 
hand-optimized assembly-language 
code uses half the instructions gen- 
erated by the Turbo Pascal compiler 
for the equivalent code. 


Possible Enhancements 

As presented, the SPA program is a 
rather basic tool. Its present form is 
in part attributable to the applica- 
tion for which I have been using it. 
Other applications will require dif- 
ferent incarnations of the basic pro- 
gram. Additional features and func- 
tions will begin to suggest them- 
selves with prolonged use of the 
SPA. Already my wish list is growing. 


Example excerpts are: 


1. A setup file that would be read at 
the start-up of the SPA program that 
would configure the SPA as I had 
previously left it. Included in this 
setup could be serial parameters, 
trigger info, and display-formatting 
information. 

2. Logging of captured data to a file 
or printer. Currently, the Shift-PrtScn 
key sequence must be used to get 
hard copy of the displayed data. 

3. The output of canned serial data 
to a COM port on the occurrence of 
a trigger. 

4. Increasing the trigger capability 
from a single byte to multibyte pat- 
terns or strings. 

5. Other serial data formats—for ex- 
ample, BiSync, HDLC, and SDLC. 


Maybe inspired readers can add 
these functions (and more) and gra- 
ciously provide me with the code 
modifications. If I receive enough 
suggestions and modifications, I'll 
collect them into a usable form and 
write another article describing 
them. 


Modification 

and Testing Issues 

At the present time, the SPA pro- 
gram has never been tested (for any 
length of time) above 2,400 baud 
because I lack the equipment to test 
it throughly. It has been tested sub- 
stantially at 1,200 baud in the devel- 
opment of an Xmodem protocol. If 
you require baud rates above 2,400 
for your application, you may need 
to make minor changes to the pro- 
gram to allow it to keep up. With 
rates above 4,800 baud, I recom- 
mend using an IBM PC AT. In the 
future I hope to test it out thor- 
oughly above 2,400 baud (read, as 
soon as my project at work slows 
down some). 

As mentioned previously, the soft- 
ware as presented is optimized for 
the pass through mode of connec- 
tion. If you would rather use the 
passive monitoring connection, you 
can modify the software to improve 
its performance. The modifications 
are as follows: 


1. Remove the section of code in 


SPA.PAS (in main) that forks off the 
OutputCOM1Data and OutputCOM2- 
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IW High-speed compilation @ ANSI compiler and library 

IW High-performance code W@W Full-screen library 

iW Reentrant code options [WY Full-screen symbolic debugger 
iY OS linkage options iW Extensive on-line documentation 
IY In-line functions IW Development tools 


WATERLOO C Version 3.0 is the 
high-performance development system 
for IBM 370 mainframe architectures 
under VM/CMS consisting of: 


¢ Optimizing C Compiler 

e C Run-time Library 

e Interactive Source-level 
Debugger 

¢ Development Tools 


WATERLOO C is ideal for new soft- 
ware development and for porting existing 
software to IBM mainframes. It provides 
ANSI standard support in an integrated 
CMS environment for portability and effi- 
ciency. And it puts all the resources of a full 
development system at your fingertips so 
you can quickly achieve quality results. 


WATERLOO C improves your 


response time and conserves your main- Completing the development environ- 
frame resources with an extremely fast ment are these important productivity 
compilation rate. A single phase from tools: 

Soros ep cumect hina thicioest dimen e Update your programs with a single 
while both the compiler and library can command: MAKE. 

reside in shared segments for even faster 


: © Simplify multi-file maintenance with 

compiles and links. GREP and DIFF. 

¢ Track source variables and functions with 
cross-reference utilities. 

© Spot performance bottlenecks with a 
program execution profiler. 


WATERLOO C generates the highest 
quality code with an exclusive state-of-the- 
art optimizer. Options for reentrant applica- 
tions and OS linkage conventions mean 
flexibility in development. Moreover, a 
convenient option allows you to see the 
Original source lines as comments in the 


A full support framework provides com- 
plete technical backup. Access documen- 
tation easily on-line or in comprehensive 


BUREN) oni 


assembler output. reference manuals. Our Customer Support & 
Center provides you with expert technical | 

The source-level debugger lets you assistance. Newsletters keep you informed §f 

work with your programs the way you about product developments. And on-site 5 
wrote them. The full-screen interface feels installation and training workshops are . 


so natural that it is easy to use. Debugging _ available. 
activity is performed using source varia- —x, 
bles, functions, and lines. And 
the execution environment 
allows stepping, breakpoints, 
tracing, and display and alter- 
ation of your program data. 





= 


OG TESA 
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IBM is a trademark of the International Business Machines Corporation. © Copyright 1987 WATCOM Products Inc. 
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be Please send your product 
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& | would like to arrange for an 
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Company: 

Street: 
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Ir you program in C, take a few 
moments to learn how Windows for 
Data can help you build a state-of-the- 
art user interface. 


lw Create and manage menus, data-entry forms, context- 
sensitive help, and text displays — all within windows. 

Develop window-based OS/2 programs right now, 
without the headaches of learning OS/2 screen manage- 
ment. Run the same source code in PCDOS and OS/2 
protected mode. 


i Build a better front end for any DBMS that has a C- 
language interface (most popular ones do). 





| | 





FROM END TO BEGINNING 


Windows for Data begins 
where other screen packages end, 
with special features like nested 
pop-up forms and menus, field en- 
try from lists of choices, scrollable 
regions for the entry of variable 
numbers of line items, and an ex- 
clusive built-in debugging system. 


NO WALLS 

If you’ve been frustrated by the limitations of other 
screen utilities, don’t be discouraged. You won't run into 
walls with Windows for Data. Our customers repeated- 
ly tell us how they’ve used our system in ways we never 
imagined — but which we anticipated by designing Win- 
dows for Data for unprecedented adapatability. You will 
be amazed at what you can do with Windows for Data. 





Date: 


(Y/N): 
(Y/N): 
(Y/N): 
Enter marketing information? (Y/N): 


DESCRIPTION 





0%,, 


WINDOWS FOR DATA® 


Time: 
—Custoner——_—____—— 
William Jones 
Innovative Software 
351 Bulletin Avenue 
Needham, MA 82194 
(617) 394-5512 


QUANTITY PRICE AMOUNT 


Subtotal: 
Shipping; 


TOTAL 


Paument : 


nd ESC exits choice menu 


YOU ARE ALWAYS IN CHARGE 

Control functions that you write and attach to fields 
and/or keys can read, compare, validate, and change the 
data values in all fields of the form. Upon entry or exit 
from any field, control functions can call up subsidiary 
forms and menus, change the active field, exit or abort 
the form, perform almost any task you can imagine. 


SS 


(xt ee 

Sa 

Le eA Ree Z - ~ 
— ' ~ an s 


OUR WINDOWS 
WILL OPEN DOORS 

Our windows will open doors to 
new markets for your software. 
High-performance, source-code- 
compatible versions of Windows 
for Data are now available for 
PCDOS, OS/2, XENIX, 
i £41 UNIX, and VMS. PCDOS 
versions are fully compatible with Microsoft Windows. 
No royalties. 

You owe it to yourself and your programs to try 
Windows for Data. If not satisfied, return for a full 
refund. 

Prices: PCDOS $295, Source $295. OS/2 $595. 
XENIX $795. 





Call: (802) 848-7731 
Telex: 510-601-4160 VCSOFT 


ext. 31 
FAX 802-848-3502 





(~ Vermont 21 Elm Ave. 
weaag Creative Richford, 
wy Software VT -05476 
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PROTOCOL ANALYZER 
(continued from pagen 40) 


Data tasks. These aren’t needed for 
the passive monitor conection be- 
cause the SPA’s PC doesn't have to 
output any data. 
2. Modify the code in the tasks Move- 
COM1Data and MoveCOM2Data so 
that they don’t move the serial data 
to the output FIFOs. From Move- 
COM1Data, remove the line: 
PutSerial- 
Data(Sd,COM2__Output__Fifo); 
and from MoveCOM2Data, remove 
the line: 
PutSerial- 
Data(Sd,COM1__Output__Fifo); 


These changes will eliminate two 
unnecessary tasks from being exe- 
cuted and will speed up (slightly) 
the processing of data in two other 
tasks. The original code is required, 
however, when the SPA is config- 
ured for the pass through method 
of connection. 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb's Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
Macintosh, Kaypro). 


DDJ 


(Listings begin on page 44.) 


Vote for your favorite feature/article. 
Circle Reader Service No. 5. 
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The Software 
WV 


e the only complete version of AWK available for DOS; ; 
fully compatible with the latest description in The AWK Programming 
Language, by Aho, Weinberger, and Kernighan; 

easy to learn, giving beginners results with little effort; 

the natural introduction to mastering the C programming language; 

text substitution and pattern matching; 

definable functions; 

associative arrays and regular expressions: 

hardware floating point and large model version; 

rapid prototyping tool for larger programs. 






The AWK 


: = 

e written by the authors of the original 
UNIX-based program, Alfred V. Aho, Peter J. 
Weinberger, and Brian W. Kernighan; 

e the definitive book on AWK just as “The C 
Programming Language,” by Kernighan and 
Ritchie, defined C:; 

e recently published by Addison-Wesley: 

e lists at $21.95; 

* with MKS AWK only $14.00. 






Language 









Arrrep V. AHO 
Brian W.KERNIGHAS 
Picrer J. WEINBERGER 






Experience the power of a UNIX programming language on your desktop PC without 
sacrificing your investment in DOS applications and training. 


AWK is a versatile first language for non-programmers and a sophisticated data retrieval 
and report generation tool for the experienced user. Based on a sequence of terse 
pattern/action rules, AWK allows you to manipulate files for retrieval, transformation, 
reduction, and validation of data. MKS AWK comes with full technical and tutorial docu- 
mentation to speed your mastering of this fourth generation programming language. 


MKS AWK sells for $75. 
Order both the software and the book from MKS for $89. 


Slee 
Also available: 

The MKS-Toolkit:-over 110-UNIX-based tools for DOS including the Korn Shell, Vi, and AWK, 

complete with nearly 400 pages of documentation and tutorials. The complete package: $139. 

MKS Vi: The UNIX screen editor running under DOS at lightning fast speeds — it’s tuned for the PC. 

Comes with Tutorial and Reference Manual for $75. 

MKS RCS: Running under DOS, the Revision Control System allows the efficient control and 

recording of revisions of text files such as programs, documentation, graphs, form letters, and so 

on. A complete system for $189. 


esses: 


Mortice Kern Systems Inc., 
35 King Street North, Waterloo, Ontario, Canada N2) 2W9 (519) 884-2251 
BIX User Name: mks CompuServe User ID: 73260,1043 


MKS software runs under MS-DOS 2.0 or later. Not copy protected. Prices quoted in US funds. VISA, 
MASTERCARD, American Express, uucp, and purchase orders (over $200) are accepted. Overseas orders please 
add $15 for postage and handling. MKS is a registered trademark of Mortice Kern Systems Inc. UNIX is a 
trademark of AT&T Bell Labs. MS-DOS is a trademark of Microsoft Corp. 
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PROTOCOL ANALYZER _ 


Listing One (Text begins on page 30.) 





{ RERKKKAKKKKKKKEKREKKEKEKKKREREKKEKKEKKKKKKEKREKKEKEKKE | 


{eae ake) 
{2% Turbo Pascal eee) 
{*x* Serial Protocol Analyzer kak} 
{xxx written by vila: 
{*** Craig A. Lindley saliahad | 
{eee ee} 
{*** Ver: 2.0 Last update: 08/15/87 wee} 
{*** rx} 


{RERAKKEKAKAEKHEKKKKKKKEKKKEAEKKEKEKEKEKHKEKEKEKEKEKEKEEEEE } 


{$K-,U-, C-, G30,D-} 


{ eoee--- Notes on compiler directives --------- } 
K- No stack checking otherwise multitasking} 
kernal will not run. } 


U-,C- Turn off user break checks to speed } 
screen I/O. } 
G30,D- Buffer standard input device (keyboard) } 
and disable device checks. This makes } 
keyboard respond much faster and be } 
buffered. } 


ee ee ee Ol ee eee ee) 


CONST 
HexDigits: STRING[16] = *0123456789ABCDEF’ ; 


AsciiStrs: ARRAY[0..31] OF STRING[3] = 
(*‘Nul’,’Soh’,’Stx’,’Etx’,’Eot’,’Enq’,’Ack’,’Bel’, 
’Bs! , Ht! Pe © ive! , FE! rept ,'So! Bee no ; 
'Dle’,’Del’,’Dce2’,’Dce3’,’Dc4’,’Nak’,’Syn’,’Etb’, 
‘can’ ,;’Em’ ,'Sub’;"Esc’,’Fs’ ,'Gs’.,"Rs' ove ys 


SerialDataFifoSize = 2000; {serial data fifo size} 


DisplayFifoSize = 3000; {display fifo size} 


{$I multi.pas} {include the} 
{multitasking kernel} 


TYPE 


FullsString = STRING[255]; 
Strso0 = STRING[80]; 
Str = STRING[3]; 


DataRec = RECORD 
Data, 

Status: Byte; 
END; 


DisplayRec = RECORD 

Tag: (FromCOM1,FromCOM2) ; 
DR: DataRec; 

END; 


{This fifo overhead structure is the same for} 
{all fifo types regardless of the items to be} 
{stored in the fifo. Two types are fifos are } 
{defined. } 


OverHead = RECORD {fifo overhead data} 
{structure} 
Count, {# of items in fifo} 
Inptr, {ptr to where items are} 
{stored} 
Outptr: Integer; {ptr to where items are} 
{fetched} 
NotEmpty, {ptrs to waiting tasks} 
NotFull: tcbptr; 
END; 


{definition of a serial data fifo} 
SerialDataFifo = RECORD 


Ovd: OverHead; {fifo overhead} 
Data: ARRAY[1..SerialDataFifoSize] 
OF DataRec; {fifo data area} 
END; 


{definition of display fifo} 
DisplayFifoType = RECORD 
Ovd: OverHead; 
Data: ARRAY[(1..DisplayFifoSize] 
OF DisplayRec; 
END; 


DisplayTriggerType = (Before,After); 


VAR 





regs: register type; 


{storage for the original IRQ3 & 4 code segment} 
{and instruction pointer addresses} 


OldIRQ3_ CS, 
O1dIRQ3_IP, 
OldIRQ4 CS, 
OldIRQ4 IP: Integer; 


{UART status storage variables} 


O1ldCOMl Status, 
O1ldCOM2 Status, 
COM1 Status, 

COM2 Status: Byte; 


{Display formatting boolean flags} 


UpdateScreenStatus, 
AsciiDisplay, 
HandShakeDisplay, 
AddSpace, 


{Data display boolean flags} 
{If true the data from the specified COM port} 
{is tagged and then moved into the display fifo} 


COM1 Display Data, 
COM2 Display Data, 


{Data Acquisition boolean flags} 

{Controls acquisiton of data by the Interrupt} 
{Serivce Routines. If true then serial data is} 
{stored by the ISR. } 


COM1_ Data Acquire, 
COM2_Data_ Acquire, 


{Variables used for the triggering function} 


TriggerEnabled, 

COM1 Is Triggered, 

COM2_ Is Triggered: Boolean; 
TriggerPattern: Integer; 
TriggerMode: DisplayTriggerType; 


{Fifo declarations} 

COM1_ Input _Fifo, 

COM2_Input_Fifo, 

COM1_ Output _Fifo, 

COM2_ Output _Fifo: SerialDataFifo; 
DisplayFifo: DisplayFifoType; 


{Screen formatting strings built at run time to} 
{format the screen. } 


Linel, Line2, 
Line3, Line4, 


Line5, Line6é, 
Line24: Strso; 


{Cursor storage for DisplayCOMData procedure} 


OldxXPos, 
OldYPos: Integer; 


{Lock for screen control} 
ScreenAccess: Semaphore; 


{XRKKKKKKEKER Begin FIFO Procedures KaKKKKKKKKKKK) 
PROCEDURE Init_Fifos; 
PROCEDURE Initialize fifo(VAR o:OverHead); 
{Initialize a fifo’s overhead data structure. } 


{This procedure will work with any type fifo.} 
{This makes the fifo appear empty. } 


BEGIN 
o.Count := 0; {count is empty} 
6.Inper. <=.1; {ptrs to lst entry} 
o.Outptr := l; {put in and take out at} 
{entry 1} 
o.NotEmpty :=NIL; {signals to nil} 
Oo.NotFull :=NIL; 





(continued on page 46) 


Dr. Dobb's Journal, February 1988 














4.5 Switch 


( prwides a ypecal form of multuipieshowe control structure tor the BE 
wtuation un which all the chovoes are specific alternative values for one integer 













€ section of cade. there should he a break siatement which 
to the clown ace alter the statements Our KUN 
’ 


RELIABLE DATA STRUCTURES IN C 
2.8 Overflow 


Strictly speaking, there are two different types of overflow When 
ect is assigned & value that is too large for the object, we have a 
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e . we ha n “interme: Mm 
The consequences are the same in both cases the end result is incorrect 
Range overflows have been discussed earlier, now we will attend to 
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intermediate overflows 









Many C programmers have assumed that (on 2 twos-complement 
machine) overflows can be ignored in most cases Consider the follow 
ing (simplified) version of the etot function 
tapi (et 


return (nm); 





We will refer to a “fussy” overflow as one which would not prevent the § 
computation of the correct answer if overflow-checking wer 

formed. For exa imple, during the computation of stepi("3z76™), 2 
“fussy” overflow takes place when the final «7 is added 

* = 32760 
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Listing One (Listing continued, text begins on page 30.) 


END; 

BEGIN 
Initialize fifo(COMl Input_fifo.Ovd); 
Initialize fifo(COMl Output_fifo.Ovd); 
Initialize fifo(COM2 Input _fifo.Ovd); 
Initialize fifo(COM2_ Output_fifo.Ovd); 
Initialize fifo (DisplayFifo.Ovd) ; 

END; 

PROCEDURE PutSerialData (d:DataRec; 

VAR £:SerialDataFifo) ; 


BEGIN 


WITH f£.Ovd DO 


BEGIN {check if fifo full} 

IF Count = SerialDataFifoSize THEN 

BEGIN {if so go to sleep} 
waitfor := addr (NotFull); 
wait; 

END; {when not full add} 

Count :=Count+l; {one more to count} 

f.data[Inptr]:=d; {store the data record} 

Inptr:=Inptr+1; {bump input pointer} 

IF Inptr > SerialDataFifoSize THEN 
Inptr:=1; {wrap ptr if necessary} 


{if waiters for this fifo wake them} 
IF NotEmpty <> NIL THEN 
send (NotEmpty) ; 
END; 
END; 
PROCEDURE GetSerialData (VAR f:SerialDataFifo; 
VAR d:DataRec); 


BEGIN 


WITH f£.Ovd DO 


BEGIN {check if fifo empty} 
IF Count = 0 THEN 
BEGIN {if so go to sleep} 
waitfor := addr (NotEmpty); 
wait; 
END; 


{when data is available} 
Count:=Count-1; {one less to count} 
d :=f.data[(Outptr]; {get the data record} 
Outptr:=Outptr+1l; {bump output pointer} 
IF Outptr > SerialDataFifoSize THEN 
Outptr:=1; {wrap ptr if necessary} 
{if waiters for this fifo wake them} 


IF NotFull <> NIL THEN 
send(NotFull); 
END; 
END; 
PROCEDURE PutDisplayData (d:DisplayRec; 
VAR f£:DisplayFifoType) ; 


BEGIN 


WITH £.Ovd DO 


BEGIN {check if £ifo full} 
IF Count = DisplayFifoSize THEN 
BEGIN {if so go to sleep} 
waitfor := addr (NotFull); 
wait; 
END; {when not full add} 
Count :=Count+l; {one more to count} 


f.data[Inptr]:=d; {store the data record} 
Inptr:=Inptrt+l; {bump input pointer} 
IF Inptr > DisplayFifoSize THEN 

Inptr:=1; {wrap ptr if necessary} 


{if waiters for this fifo wake them} 
IF NotEmpty <> NIL THEN 


send (NotEmpty) ; 
END; 
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END; 

PROCEDURE GetDisplayData (VAR f:DisplayFifoType; 
VAR d:DisplayRec) ; 

BEGIN 


WITH £.Ovd DO 


BEGIN {check if fifo empty} 
IF Count = 0 THEN 
BEGIN {if so go to sleep} 
waitfor := addr (NotEmpty); 
wait; 
END; 


{when data is available} 
Count:=Count-l; {one less to count} 
d :=f.data[Outptr]; {get the data record} 
Outptr:=Outptrt+1l; {bump output pointer} 
IF Outptr > DisplayFifoSize THEN 
Outptr:=1; {wrap ptr if necessary} 
{if waiters for this fifo wake them} 


IF NotFull <> NIL THEN 
send (NotFull); 


END; 
END; 
{Include the menuing system} 
{$I menu.pas} 
{Include the serial procedures} 
{$I serial.pas} 


{xxxxxxxex*e Additional Serial Procedures *********} 


PROCEDURE SetBreak (PortAddr:Integer; State:Boolean) ; 


{Controls the break generation for the specified} 
{COM port.} 


VAR 
Temp: Byte; 
BEGIN 


{Read the LineControl reg of the 8250} 
{either set or reset the break bit D6} 
{as specified. Write the new reg value} 
{back to the port} 


Temp := port (PortAddr+LineControl]; 
IF State THEN 
Temp := Temp OR $40 
ELSE 
Temp := Temp AND SBF; 
port [PortAddr+LineControl] := Temp; 


END; 


PROCEDURE MakeHandShake (PortAddr: Integer; 
Status: Byte) ; 


VAR 
Temp: Byte; 

BEGIN 
{Set the bits in the ModemControl reg of the} 
{specified COM port according to the bits} 
{of the variable Status. This procedure is} 
{used to always force the handshake lines of} 
{the COM ports to agree} 
Temp := port (PortAddr+ModemControl]; 
IF (Status AND BrkBit) <> 0 THEN 

SetBreak (PortAddr, True) 


ELSE 
SetBreak (PortAddr,False); 


(continued on page 48) 
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= Since so many embedded microcomputer designs employ 

fea more than one processor, you'd think there would be many tools 

F to trace multi-processor dialog in both assembly-level and high- 

P= level code. And then time-align the results. 

- In fact, there's only one. The Software Analysis Workstation™ 
(SAW) from NWIS. 

____ The SAW alone gives you a choice of a time-aligned, 
assembly-level trace on both processors. Or a time-aligned trace 
of module/procedure events on one processor and assembly-level 
activity on a second processor. 

At last, you have a fast, effective means for evaluating 
complex, inter-processor transactions as they occur in real-time 
in the target system. 

The SAW’s dual-processor trace is displayed in a fully time- 

~ ynchronized manner, so you can instantly analyze relation- 

Seti the two execution streams. Scroll the trace from 


ZANYWZS 


NORTHWEST INSTRUMENT SYSTEMS, INC. 
P.O. Box 1309 * Beaverton, OR 97075 *1-800-547-4445 


At last, 
‘Mmult-processor 
time-aligne 







d trace 


one processor, and the trace from the other processor can 
be locked to scroll right along with it. The timing relation- 
ship between the two traces automatically stays intact, even 
if the two processors have different clock frequencies. 

And multi-processor, time-aligned trace is only one of 
the SAW’s outstanding debug, optimization and verification 
functions. You also get real-time, non-intrusive performance 
analysis. And CodeMap,™ for rapid and complete verification of 
code coverage. All these tools are compiler/assembler and host 
development computer independent. : 

The SAW is already producing dramatic results for software 
engineers around the world. Let us connect ssa : 
the SAW to your target system and you'll see 
why. For an on-site demo and free 
applications library, 
phone: 1-800-547-4445 
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PROCEDURE DisplayHandShakeStatus (PortAddr: Integer; 
Li ® nae re = . InStatus, 
isting One (Listing continued, text begins on page 30.) peat athasaeta)- 
IF (Status AND CTSBit) <> 0 THEN 
Temp := Temp OR $02 
ELSE 


CONST 


StatLineNum = 3; {screen line of line status} 
Temp := Temp AND SFD; F - 
Pp Pp $ InLineNum = 4; {screen line of in handshake} 
: {lines} 
IF (Status AND DSRBit) <> 0 THEN - P 
Temp := Temp OR $01 OutLineNum 5; {screen line of out handshake} 


ELSE {lines} 


Temp := Temp AND $FE; 


cDOffset = 1l; {offsets on a screen line for} 
{Store the new value of the ModemControl} Rioffset = 16; {the individual items to be} 
cTSOffset = 28; 
BRKOffset = 13; 
ort [PortAddr+ModemControl] := Temp; r, 
PORr J P FEOffset = 18; 
PEOffset = 23; 
pts OROffset = 28; 
DTROffset = 12; 
{XREKEKKKEKKEKEE Display Procedures KRKKKKKKKKKKEKE } RTSOffset r 22; 
PROCEDURE BuildDisplay; -_ 
; DisplayOffset: Integer; 
{Setup the main SPA display screen} at ay i eee ee 
{The Ol1dCOM? Status variables are consciencely} : ; 
{clobbered to force the screen to be updated} BEGIN 


{after it is built or rebuilt after the menus} 


{are displayed} {Where an item is displayed is determined in} 


{part by which COM status is being displayed} 
{COMl1’s offset is 0 whereas COM2’s offset is} 
{51 character positions. } 


BEGIN 


O1dcOM1 Status 
O1dcCOM2 Status 


:= SFF; 


:= SFF; IF PortAddr = COMl1 THEN 


WriteStringAt (Linel,High,1,1); 
WriteStringAt (Line2, Low, 1,2); 
WriteStringAt (Line3, Low, 1,3); 
WriteStringAt (Line4, Low, 1,4); 
WriteStringAt (Line5, Low, 1,5); 
WriteStringAt (Line6, Low, 1,6); 
WriteStringAt (Line24,Rev, 1,24); 


END; 


DisplayOffs 
ELSE 
DisplayOffs 


et := 0 


et := 51; 


IF (InStatus AND BrkBit) <> 0 THEN 


Ind := ’B’ 
ELSE 

Ind := ‘-'; 
WriteStringAt ( 








Workstat 


Looking for a lightning- 
quick 386 system that's 
tailored to your needs? 
CAE/SAR Systems, Inc. will 
custom-fitf you a 386 
system more powerful 
than most on the market. 
Whether it's a system 
designed for your program 
development, artificial 
intelligence, CAE, or 
systems design work, CAE/ 
SAR delivers reliable, 
powerful 386 workstations 


built for today's program- 
mers. 


The Custom 386 
Programmer s 


ion 

Based on a proven 386 
motherboard, CAE/SAR 386 
systems Come in dozens of 
different configurations for 
memory, disks, floating 
point and graphics. You 
can select high speed 
drives (16 ms), 7OMb, 
140Mb, or 300Mb; EGA or 
mono monitors and cards; 
and 2.5Mb, 4.5Mb, or 8.5Mb 
32-bit RAM— plus other 
options! 

The CAE/SAR 386 systems 
run Unix and DOS concur- 
rently, and also run OS/2 
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Ind, High, 
BRKOffset+DisplayOffset, 


StatLineNum) ; (continued on page 51) 


‘The winner, though, was the 
CAE/SAR 386. Its ESDI hard 
disk interface made it the 
fastest of all the machines in 


the disk access test." 


PC Magazine 
Dec. 22, 1987 





and Xenix. Floating point 
options are available for the 
Intel 387 chip. 


Basic Unix/Xenix 
systems start at $3,495. 


Get a system that fits you 
perfectly. Call CAE/SAR 
Systems today for more 
information. 


CAE/SAR Systems, Inc. 
P.O. Box 50243 


Palo Alto, CA 94303 
(415) 949-3816 
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A PASCAL COMPILER 
You can program as much as you want in ISO Standard Pascal, or use the a 
powerful extensions we've added to this production quality compiler. And Mo tn eg ee 
you get complete integration with C and assembly language as well. ee 





Working together, the G8K Cross Development Tools deliver both 
optimized performance and improved programmer productivity. 
Best of all, Whitesmiths offers everything you need at a very com- 
petitive price. We've been delivering and supporting high quality 
software development tools since 1978, and we’re committed to 
continually enhancing our product line. 









If you develop 68000 programs on a DEC VAX, an IBM PC, or a 
UNIX workstation, chances are we can save you time and money. 
For more technical details, call our toll-free number today. We also 
offer attractive packages for OEMs. 













59 Power Road 
Westford, MAO 1886 
617/692-7800. Hg 
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Blow away the 640K barrier 


OS/286™ & OS/386™ Benefits: 
. Make ¢ Gain multi-megabytes of direct- 
je} te ols ole ls -losakwallamehiece ly addressable memory (15-Mb- 


. 286, 4Gb-386 
in protected mode 


¢ Increase performance by elimi- 
nating overlays and EMS 


¢ Convert in days, not months 


¢ Continue to work with a DOS 
interface and use existing TSRs, 
device drivers, graphic routines, 
etc. 


¢ Stay compatible with the widest 
array of systems 
A.I. Architects Software Devel- 
opers Kit $495 
includes full support for: 
¢ MetaWare High C (16 & 32 bit) 
¢ Professional Pascal (16 & 32 bit) 
¢ Lahey F77L FORTRAN 
¢ Microsoft C & Fortran 4.0, 
¢ MASM, MS-Link 
¢ Phoenix PLINK86 
¢ Halo & GSS Graphics 
¢ Pharlap 386: ASM/LINK 
more to come 


Run time licenses for OS/286 
and OS/386 are available at 
nominal cost. 
































Gain the benefits of protected 
mode the easy way with OS/286™ 
and OS/386™. These tools for C, 
Fortran, Pascal and Assembly 
language programmers permit 
rapid conversion of existing DOS 
applications from “real” 8086 
mode to “protected” 286 and 386 
mode. They don’t replace or mod- 
ify DOS, but extend it to protected 
mode. 


OS/286 and OS/386 are the only @ 
DOS extenders that span both the | 
286 and 386 processors, with 32- 
bit capability today on 386s that 
yields twice the performance of _ 
16-bit mode. OS/286 and OS/386 | 
have quickly become the prefer- 
red solution for developers of high 
performance, memory-intensive 
applications, including CADKEY, 
CASE, VIEWlogic, and Gold Hill, 
and premier language developers 
Lahey and Metaware. 


Our optional TOUCHDOWN ™ 
BIOS supplement provides fast 
and reliable protected mode oper- 
ation on any 286 system, even 
those with problems resetting the 
286. (Ever notice how few existing 
machines Operating System/2 
runs on?) 







If your applications are run- 
ning out of memory or need more 
speed, don’t wait for the “solu- 
tion” that means abandoning 
your investment in DOS. 


Enhance them now _ with ; i 
architecture boosts performance sig- 
OS/286 and OS/386 — products nificantly over comparable single 


not promises. processor systems or accelerator 
boards. Available with 2 to 24Mb 


RAM, 16 or 20Mhz speed, and 387 


Architects, Inc. floating point coprocessor. 
One Kendall Square, Building 400 


Cambridge, Massachusetts 02139 
(617) 577-8052 





The HummingBoard™ 
turns any XT or AT into the fastest 386 
system available. The dual processor 


OS/286, OS/386 and HummingBoard are trademarks of A.L Architects, Inc., High C and Professional Pascal are 
trademarks of Metaware, Inc., F77L FORTRAN is a trademark of Lahey Computer Systems, Inc., Microsoft and MS-DOS are trademarks of Microsoft Corp. 
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Listing One (Listing continued, text begins on page 30.) 


IF (InStatus AND FEBit) <> 0 THEN 
Ind := ‘E’ 
ELSE 
Ind := ’-'; 
WriteStringAt (Ind,High, 
FEOffset+DisplayOffset, 
StatLineNum) ; 


IF (InStatus AND PEBit) <> 0 THEN 
Ind := ’E’ 
ELSE 
Ind := ’-'; 
WriteStringAt (Ind,High, 
PEOffset+DisplayOffset, 
StatLineNum) ; 


IF (InStatus AND ORBit) <> 0 THEN 
Ind := ‘E’ 
ELSE 
Ind := ’-’; 
WriteStringAt (Ind,High, 
OROffset+DisplayOffset, 
StatLineNum) ; 


IF (InStatus AND CDBit) <> 0 THEN 
Ind := /M’ 
ELSE 
Ind := ’S’; 
WriteStringAt (Ind,High, 
CDOffset+DisplayOffset, 
InLineNum) ; 


IF (InStatus AND RIBit) <> 0 THEN 
Ind := ‘M’ 
ELSE 
Ind := °S8’; 
WriteStringAt (Ind, High, 
RIOffset+DisplayOffset, 
InLineNum) ; 


IF (InStatus AND DSRBit) <> 0 THEN 
Ind := ‘’M’ 
ELSE 
Ind := ’s’; 
WriteStringAt (Ind,High, 
DSROffset+DisplayOffset, 
InLineNum) ; 


IF (InStatus AND CTSBit) <> 0 THEN 
Ind := ’M’ 
ELSE 
Ind := °8S’; 
WriteStringAt (Ind,High, 
cTSOffset+DisplayOffset, 
InLineNum) ; 


{Note: The OTHER COM port is consulted about} 
{the output status. DTR of this port should} 
{equal DSR of other port. RTS of this port} 
{should equal CTS of other port} 


IF (OutStatus AND DSRBit) <> 0 THEN 
Ind := ’M’ 
ELSE 
Ind := ’S’; 
WriteStringAt (Ind, High, 
DTROffset+DisplayOffset, 
Out LineNum) ; 


IF (OutStatus AND CTSBit) <> 0 THEN 
Ind := ’M’ 
ELSE 
Ind := ’S’; 
WriteStringAt (Ind,High, 
RTSOffset+DisplayOffset, 
Out LineNum) ; 


END; 


PROCEDURE DisplayBufferStatus; 
VAR 


PerCentage: Integer; 
PerCentStr: Strs80; 
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BEGIN 


PerCentage := Round((COMl1 Input _Fifo.Ovd.Count/ 


SerialDataFifoSize) * 100); 
Str (PerCentage:2,PerCentStr) ; 
WriteStringAt (PerCentStr + ’%’,High,12,2): 


PerCentage := Round((COMl1 Output_Fifo.Ovd.Count/ 
SerialDataFifoSize) * 100); 

Str (PerCentage:2,PerCentStr); 

WriteStringAt (PerCentStr + ’%’,High,26,2); 


PerCentage := Round((COM2_ Input_Fifo.Ovd.Count/ 
SerialDataFifoSize) * 100); 

Str (PerCentage:2,PerCentStr); 

WriteStringAt (PerCentStr + ’%’,High, 63,2); 


PerCentage := Round((COM2 Output_Fifo.Ovd.Count/ 
SerialDataFifoSize) * 100); 

Str (PerCentage:2,PerCentStr) ; 

WriteStringAt (PerCentStr + ’%’,High,77,2); 


PerCentage := Round((DisplayFifo.Ovd.Count/ 
DisplayFifoSize) * 100); 

Str (PerCentage:2,PerCentStr); 

WriteStringAt (PerCentStr + ’%’,High,47,5); 


END; 


FUNCTION FormatCharAscii (Num:Integer) : Str3; 
BEGIN 


IF Num < ORD(’ ’) THEN 
FormatCharAscii := AsciiStrs [Num] 
ELSE 
FormatCharAscii := chr(Num); 


END; 


(continued on next page) 


FULL AT&T C++: ANNOUNCING VERSION 1.2 


Guidelines announces its port of version 1.2 of AT&T’s C++ translator. As an 
object-oriented language, C++ includes: classes, inheritance, member functions, 
constructors and destructors, data hiding, and data abstraction. “Object-oriented” 
means that C++ code is more readable, more reliable and more reusable. And that 
means faster development, easier maintenance, and the ability to handle more 
complex projects. C++ is Bell Labs’ answer to Ada and Modula 2. C++ will 
more than pay for itself in saved development time on your next project. 


C++ 


from GUIDELINES for the IBM PC: $295 





Requires IBM PC/XT/AT or compatible with 640K and a hard disk. 
Note: C++ is a translator, and requires the use of Microsoft C 3.0 or later. 


Here is what you get for $295: To Order: 
The full AT&T v1.2 C++ translator. send check or money order to: 
Libraries for stream I/O and complex math. 
The C++ Programming Language, the 
definitive 327-page tutorial and description 
by Bjarne Stroustrup, designer of C++. 
Sample programs written in C++. To order with Visa or MC, 
Improved installation guide and phone (800) 634-7779; 
documentation. in CA, (415) 254-9393. 
30-day money-back guarantee. (CA residents add 6% tax.) 


GUIDELINES SOFTWARE, INC. 
P.O. Box 749, #DDJ 
Orinda, CA 94563 


C++ is ported to the PC by Guidelines under license from AT&T. 
Call or write for a free C++ information package. 
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PROTOCOL ANALYZER 


Listing One (Listing continued, text begins on page 30.) 





IF HandShakeDisplay THEN 
FUNCTION FormatCharHex (Num:Integer) : Str3; Temp := Temp + ’:$’+ 
FormatCharHex(DR.Status); 
BEGIN 
{write serial data string to display} 
FormatCharHex := WriteString (Temp, VideoAttrib) ; 
HexDigits[(Num SHR 4) AND SOOOF +1 ] + : ; 
HexDigits[(Num AND S$O0O0F) + 1]; {if formatting with spaces} 
IF AddSpace THEN 

END; BEGIN 


{output space to display and add} 
{a space to string for length calc} 
write(’ ’); 

Temp := Temp + ’ ‘’; 


FUNCTION DisplayData (D:DisplayRec) : Integer; 





VAR END; 
VideoAttrib: AttribType; {ret length of formatted item} 
Temp: STRING[7]; DisplayData := length(Temp); 
END 
BEGIN ELSE 
{if no data ret 0 length} 
WITH D DO DisplayData := 0; 
BEGIN END; 
{If data from either channel should be} 
{displayed then...} END; 
IF (((Tag = FromCOMl1) AND COMl Display Data) OR {****kekekeK Miscellaneous Procedures *****kkkxex} 
((Tag = FromCOM2) AND COM2 Display Data)) THEN 
BEGIN a ~ PROCEDURE Init Program; 


{set video attribute depending upon} 
{which COM channel it is from} 
IF Tag = FromCOMl THEN 
VideoAttrib := Low 
ELSE BEGIN 
VideoAttrib := Rev; 


{Perform default initialization for protocol} 
{analyzer program} 


Init Fifos; 
{choose ASCII or Hex format} 
IF AsciiDisplay THEN 

Temp := FormatCharAscii(DR.Data) 
ELSE 

Temp := FormatCharHex(DR.Data); 


COM1 Data Acquire := True; 
COM2 Data Acquire := True; 


COM1 Display Data := True; 
COM2 Display Data := True; 
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C Programmers: Combine C and COMMON LISP 












to Increase the Power of Your Software 


‘TransLISP PLUS - 









Simple. 


Add LISP features to your software without mak- 
ing it a full time job. The TransLISP PLUS tutorial, 
on-line help, and 30 sample programs with 
commented source make it easy. 


Practical. 


Start by modifying the LISP sample programs 
and including them in a system you wrote in C. 
Yes, in C! TransLISP PLUS includes a C Language 
Interface that lets you integrate your Microsoft C 
code and libraries with all or portions of our LISP 
interpreter. 

Use TransLISP PLUS to add natural or command 
language features to replace menus... or to flexibly 
manage related but disparate information. Code 
from C libraries provided by other vendors can be 
integrated into your program to perform tasks not 
normally part of LISP. 


| The 
Coder’s 





Source ™ 541-D Main St., Suite 412, So. Weymouth, MA 02190 


Thorough. 


TransLISP PLUS took over 400 primitives from 
the most widely used and respected LISP standard, 
COMMON LISP, and made it available on IBM 
PCs, XTs, ATs, and virtually every other MSDOS 
machine. So now you can work with anything from 
a $700 PC to a $7000 PC. 

The utilities toolbox is included at no charge with 
a built-in editor, pretty printer, cross reference, 
and additional debugging tools. 

An optional Runtime encrypts your source code 
so that you can distribute your applications safely. 
You pay no royalties. 

Requires MSDOS 2.0+, 320K RAM, and a 360K floppy. 


MONEYBACK GUARANTEE 


Try TransLISP PLUS ($195) for 30 days — if not 
satisfied get a full product refund. The Optional 

Runtime is available for $150. Or start by learning 
LISP with TransLISP ($95) then upgrade to PLUS 


for $158. 
Call (800) 255-4659 


In MA (617) 331-0800 
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Again. 


Meridian continues its tradition of Ada 
“firsts”? by introducing a powerful new set 
of integrated software development tools. 


AdaVantage v2.1 Optimizing Ada Compiler 
Available for the IBM PC and compatibles and the 
Apple Macintosh. An exceptionally fast validated 
Ada compiler that for the first time brings a true 
world-class production quality Ada compiler to your 
desktop personal workstation. 


AdaVantage Debugger Aninteractive source- 
level debugger for use with programs written using 
the Meridian AdaVantage compiler. The debugger 
allows the programmer complete control over the 
execution of an Ada program in high-level Adaterms 
— no knowledge of the underlying machine archi- 
tecture is required. The debugger supports break- 
points, subprogram traces, single-stepping, call 
backtraces, and full Ada reference syntax. 


Ada Developer Interface A powerful inter- 
active screen-oriented interface to the Ada library 
dependency information. Includes built-in opera- 
tions to edit, “pretty print’, compile, and link any Ada 
library unit. Configuration file allows user tailoring of 
all operations and displays. 


Run-Time Customization Library For prep- 
aration of Ada application programs for execution 
on 80x86-based embedded systems or other op- 
erating systems. The Library is a collection of Ada 
source files, batch files, and documentation that 


milestone. 





_—_—_ a 
MERIDIAN 


ME 
Soy Go bob MS. ton. Cc. Systems, Inc. All rights reserved. 


define the customizable, system-dependent com- 
ponents of the AdaVantage Run-Time System. 


AdaStarter identical to the validated v2.1 Ada- 
Vantage compiler with limitations that permit up to 
ten library units, each with up to two-hundred execut- 
able statements (unlimited declarations and com- 
ments). This is approximately equivalent to a 4000 
line program. The price of AdaStarter is applicable 
towards purchase of the AdaVantage production 
compiler. Get the full power of Ada for only $99! 


AdaDesigner A collection of tools supporting 
the design, programming, and documentation phases 
of the software life cycle. Tools include a structured 
editor/synthesizer coupled to a text editor/incre- 
mental syntax analyzer for Ada, an incremental 
editor for design languages, a program derivation 
processor that guarantees your design is always in 
sync with your implementation, and a structured 
documentation generator. 


Configuration Thecompilersall runinastana- 
ard PC configuration with 640K of memory(1MBon 
the Macintosh) and a hard disk. 


For more information call 1-800-221 “2522. 
In California, call 714-380-9800. | 


Meridian Software Systems Ada Vantage 
version 2.0 compiler is an Ada software 
— PC Week 


23141 VERDUGO DRIVE e SUITE 105 « LAGUNA HILLS, CALIFORNIA 92653 
800/221-2522 (Outside California) ¢ 714/880-9800 (Inside California) 

Telex: 650-268-0547 MCI e Fax: 714/380-1683 

— The information contained herein is subject to change without notice. 0 Adais a registered trademark of the U.S. Government 
(AJPO). AdaVantage, AdaTraining, AdaDesigner and AdaStarter are trademarks of Meridian Software Systems, Inc.References __ 
to other computer systems use trademarks owned by the respective manufacturers. 0 Copyright ©1988 Meridian Software 
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IMAGES 


EQUATIONS = 
Eror “now supports the HP eS es os ao 
LaserJet, Imagen, Laserwriter, and oP uae 


all PosTScripT® printers! bsV 0% tae 


2a 


Our enhanced GRAPHS/PLOTS 


OMENS 
inclusion of 
graphics directly 
TOMO 
documents. 
Available on 
MS-DOS and 36 
different UNIX 
systems. 


CRT screen 
previewers for 
Colutelamole-}itiare} 
are now included 
with EROFF." 


10 15 
Population (in Millions) of 15 States 


DIAGRAMS 
mUlimele-) ales 


previewers for 
SUN and 
X-Windows are 
also available. 





Carbo 
hydrate 


Elan Computer Group, Inc. 
410 Cambridge Ave., Suite A, Palo Alto, CA 94306 
Ac ceneceese = 415.322.2450 
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PC-SH 
PCMACS PC-UTIL 


The look and feel of Unix ona PC! 
PC-SH - $4500 


includes Korn Shell features e built-in commands 
command history e debugging capability 
command editing e shell variables 
command aliasing e Unix regular expressions 
for, while, case, if, elif, else 


PCMACS - $4500 


e full feature screen editor e window size definition 
e file encryption capability © one key editor functions 
e multiple file editing e temporary file buffering 


PC-UTIL - $4500 


banner bdiff Cal cat cb 


Cflow chmod cmp col comm 


crypt cut date dd df 
dirname du echo env expr 
fgrep file find grep head 
label line Ipr Is make 
more mv mvdir od pack 
pg pr proof pwd rm 

set sleep sort Split strings 
tabify tail tee test time 
touch tr tsort unig unpack 
unset WC whence and more! 


SPECIAL OFFER — All 3 for only $99°°! 
VEGACON Corporation 
P.O. Box 415 e Convent Station, NJ 07961-0415 
Mail orders add $1.50 P&H. N.J. residents add 6% sales tax. 
VISA/MC orders: (201) 729-1696 — 30 Day Warranty 


And, of course, full documentation is included! 
*Unix and Ksh are trademarks of AT&T Bell Laboratories 
*PC-SH, PCMACS, and PC-UTIL trademarks of Vegacon Corporation 
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__ PROTOCOL ANALZYER | 





Listing One (Listing continued, text begins on page 30). 


TriggerEnabled := False; 
COM1_Is Triggered := False; 
COM2_Is Triggered := False; 


AsciiDisplay := True; 
HandShakeDisplay := False; 
AddSpace s= True; 
COM1 Status sm 0; 
COM2_ Status s= 03 


{set serial com defaults 1200 baud, 8 bit word, 
{1 stopbit, no parity} 
{both COM ports always set the same} 


COM_Rate s= 83 {1200 baud} 
COM _StopBits := 1; 

COM DataBits := 8; 

COM Parity := none; 


SetNewCOMParameter; {apply the parameters} 


END; 


PROCEDURE VerifyHardware; 
CONST 

TestByte = $5A; {try to store and retrieve} 
{this value} 

SafeByte = $03; {set default 8 bits 1 stop} 
BEGIN 


ClrScr; 
{just in case of reentry} 
Disable Serial Devices; 


WriteString(’ Serial Protocol Analyzer Hardware 
Verification Check ’ ,Rev); 
WriteStringAt (’Checking COM1’,HighBlink, 2,3); 
port [COMl+LineControl] := TestByte; 
delay(700); 
IF port[COMl+LineControl] <> TestByte THEN 
BEGIN 
WriteStringAt (’COM1 Hardware Bad or Missing’, 
Rev, 2,3); 
Halt; 
END; 
port[COMl+LineControl] := SafeByte; 
WriteStringAt (’COMl1 Hardware Verified’, 
Low,2,3); 


delay(700); 
WriteStringAt (’Checking COM2’,HighBlink, 
2,4); 

port [COM2+LineControl] := TestByte; 
delay (500); 
IF port [COM2+LineControl] <> TestByte THEN 
BEGIN 

WriteStringAt (’COM2 Hardware Bad or Missing’, 

Rev,2,4); 

Halt; 
END; 
port [COM2+LineControl] := SafeByte; 
WriteStringAt(’COM2 Hardware Verified’,Low,2,4); 


delay (2000); 
Cirscr: 


END; 


{**x*x*k*k Menu Command Processing Procedure *******x} 
{Declared forward previously} 


PROCEDURE ProcessCmd; 


(continued on page 56) 
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New Clipper: 
Because your 
dBase applications 
keep getting bigger 
and better 


Get Clippers newest release, Summer ‘87 
for far faster program execution, smoother, 
speedier development cycles and faster 
compiling than ever before. 

The more sophisticated your database 
applications become, the more you need 
the Clipper compiler. 

More Programming Power. 
New commands, functions and dBASE® 
compatible indexing make new Clipper 
the most powerful solution yet for cre- 
ating the types of dBASE III PLUS™ 
applications you're working on today. 
Single-user or networking. For example, 


fully programmable functions make it easy to browse records, 


create pop-up menus or edit free text. 


Its easy to develop your own user-defined functions and 
libraries with the Microsoft® C compiler, assembly routines 
or Clipper itself, and incorporate them into your application. 
And new Clipper compiles your code five times faster than 


its predecessor. 


Bottom line: You get more sophisticated, better applications, 


written quicker. 


And you stil] don't have to buy extra copies of dBASE for 


Nantucket. 








every user of your Clipper-compiled 
program, or pay runtime or licensing fees. 

Faster Program Execution. 
dBASE can bog down in complex appli- 
cations. Not with new Clipper. It's 10 
to 20 times faster than simple dBASE 
code — and even twice as fast as last 
year's Clipper. 

Update today. 

If you're currently a Clipper user, 
update to new Clipper for as little as 
$125. Included is a new manual com- 
plete with a full dBASE language 
reference section. 


If you're not yet using Clipper, theres never been a better 
time to step up to the best. 

To receive your new Clipper update, or for a free demo 
diskette, call (213) 390-7923 today. Thats Clipper. The better 
you get, the better we get. 

Nantucket Corporation. 12555 W. Jefferson Blvd., Los Angeles, 


© Nantucket Corporation, 1987 Clipper is a trademark of Nantucket Corporation. Microsoft is 
a registered trademark of Microsoft Corporation. dBASE and dBASE III PLUS are trademarks of 
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MetaWINDOW 


‘Product of the Month’ 
"... a technological tour de 
force for fast PC graphics." 


auto-cursor tracking 
pull-down menus 
pop-up windows 
comprehensive 
graphic functions 
6 multiple fonts 10 Point 12 Point 
Bolc 


Italic 


Enhanced Features! 


¢ Display multiple bitmap or 
"filled-outline" fonts. 

¢ Face fonts for bold, italic, under- 
line or strike-out stylings. 

¢ Full "RasterOp" transfer 
functions for writing, erasing, 
rubberbanding or dragging: 
lines, text, icons, bit images 
and complex objects. 

¢ Create pop-up menus, 
windows and icons. 

¢ Supports IBM's new PS/2 VGA 

and MCGA graphics. 
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Listing One (Listing continued, text begins on page 30.) 


VAR 


HexStr: 
HexChar, 
ErrCode: 
Ch: 


BEGIN 


at A 


Str3; 


Integer; 


Char; 18: 


IF cmd_code <> 0 THEN 


BEGIN 


19: 


CASE cmd_code OF 


3 


10: 


s kes 


12: 


13s 


14: 


18: 


16: 


l: ExitMenu := True; 
2: BEGIN {300 baud} 
COM_Rate := 6; 


SetNewCOMParameter; 20: 


END; 


: BEGIN {600 baud} 
COM Rate := 7; 
SetNewCOMParameter; 

END; 


: BEGIN {1200 baud} 
COM Rate := 8; ais 


SetNewCOMParameter; 
END; 


: BEGIN {2400 baud} 


COM_Rate := ll; 
SetNewCOMParameter; 
END; 


: BEGIN {4800 baud} 22: 


COM Rate := 13; 
SetNewCOMParameter; 
END; 


: BEGIN {9600 baud} 


COM_ Rate := 15; 
SetNewCOMParameter; 
END; 


: BEGIN {1 stop bit} 


COM StopBits := 1; 
SetNewCOMParameter; 
END; 


: BEGIN {2 stop bit} 


COM StopBits := 2; 
SetNewCOMParameter; 
END; 


BEGIN {5 bit word} 
COM DataBits := 5; 
SetNewCOMParameter; 

END; 


BEGIN {6 bit word} 
COM DataBits := 6; 
SetNewCOMParameter; 

END; 23 


BEGIN {7 bit word} 
COM DataBits := 7; 
SetNewCOMParameter; 

END; 


BEGIN {8 bit word} 
COM DataBits := 8; 


SetNewCOMParameter; 
END; 


BEGIN {Odd Parity} 
COM Parity := Odd; 
SetNewCOMParameter; 

END; 


24: 


BEGIN {Even Parity} 
COM Parity := Even; 
SetNewCOMParameter; 

END; 


BEGIN {No Parity} 
COM Parity := None; 
SetNewCOMParameter; 

END; 


BEGIN {Display COM1 only} 

COM1 Display Data := True; 
COM2 Display Data := False; 

END; 

BEGIN {Display COM2 only} 

COM1 Display Data := False; 
COM2 Display Data := True; 

END; 

BEGIN {Display both COMl and COM2} 
COM1 Display Data := True; 
COM2_ Display Data := True; 

END; 

BEGIN {COM1 is triggered} 
GoToxY (1,25); 

ClrEol; 
COM1 Is Triggered := True; 
COM2_ Is Triggered := False; 
WriteStringAt (’COMl1 awaiting trigger’, 
HighBlink, 3,25); 
END; 
BEGIN {COM2 is triggered} 


GoToXY (1,25); 
ClrEol; 
COM1_ Is Triggered := False; 
COM2_ Is Triggered := True; 
WriteStringAt (’COM2 awaiting trigger’, 
HighBlink,3,25): 
END; 


BEGIN {Input trigger pattern} 
GoToxY(1,MenuLine4); {position cursor} 
ClrEol; {clear line} 
WriteString ( 

‘Input trigger pattern as two hex 
digits: ’, High); 


{initialize str with hex prefix} 
HexStr := ‘S$’; 
FOR HexChar := 1 TO 2 DO 
BEGIN 
REPEAT 
{get a char} 
Ch := upcase (Char (GetKey) ); 
{loop until valid char is input} 
UNTIL pos(Ch,HexDigits) <> 0; 
{display to user} 
write(Ch); 
{add to hex string} 
HexStr := HexStr + Ch; 
END; 
{convert hex to int} 
Val (HexStr, TriggerPattern, ErrCode) ; 
GoToxyY (28,25); 
Write(’Trigger Pattern: ’, 
FormatCharHex (TriggerPattern) ); 
END; 


: BEGIN {Display BEFORE Trigger mode} 


TriggerMode := Before; 
WriteStringAt (’Mode: Display Before Trigger’ 
, LOW, 51,25); 
IF COM1 Is Triggered THEN 
{start with displaying data} 
COM1 Display Data := True 
ELSE 
IF COM2 Is Triggered THEN 
COM2 Display Data := True 
ELSE 
WriteStringAt ("Mode Error -- 
Select channel’ 
,HighBlink, 51,25); 
END; 


BEGIN {Display AFTER Trigger mode} 
TriggerMode := After; 
WriteStringAt (’Mode: Display After Trigger’ 
- ,Low, 51,25); 
IF COM1_ Is Triggered THEN 
{start without displaying data} 
COM1 Display Data := False 
ELSE 
IF COM2_ Is Triggered THEN 
COM2 Display Data := False 


ELSE 
WriteStringAt (‘Mode Error -- Select channel’ 
»HighBlink, 51,25); 
END; 


(continued on page 59) 
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“How to protect your software 
by letting people copy it?’ 


By Dick Erett, President of Software Security 





Inventor and 
entrepreneur, 
Dick Erett, 
explains his 

| company’s 
= © ‘® view onthe 
protection of intellectual 


property. 
A even sophisticated 
software develop- 

ment companies and the 

trade press seem to be miss- 

ing or ignoring is this: 
Software protection must 
be understood to be a 
distinctively different 
concept from that com- 
monly referred to as 
copy protection. 


Fundamentally, software 
protection involves devising 
a method that prevents 
unauthorized use of a 
program, without restricting 
a legitimate user from 
making any number of 
additional copies or prevent- 
ing program operation via 
hard disk or LANs. 

Logic dictates that mag- 
netic media can no more 
protect itself from misuse 
than a padlock can lock itself. 

Software protection must 
reside outside the actual 
storage media. The technique 
can then be made as tamper 
proof as deemed necessary. 
If one is clever enough, 
patent law can be brought 
to bear on the method. 

Software protection is at 
a crossroads and the choices 
are clear. You can give 
product away to a segment 





crucial point that 





Hard Disk Installation : Simply copy pega disk 
to hard disk using DOS Command - Copy A:*. Cc: 






the program diskette as you wish. 


Data Back-ups : Use normal back-up and restore 
commands, including backing up sub-directories containing 


program files. 












ogram Back-ups : You may make as many copies of 






Networks : This product may be 

s. Follow the same installation 

yage 102 of this manual. The Block 
ith the normal operation of any 


CAINPIIOId 











Soon all software installation procedures will be as straightforward as this. 


The only difference will be whether you include the option to steal your 


product or not. 


of the market, or take a 
stand against the theft of 
your intellectual property. 


‘... giving your software 
away Is fine...”’ 


We strongly believe that 
giving your software away 
is fine, if you make the 
decision to do so. However, 
if the public’s sense of ethics 
is determining company 
policy, then you are no 
longer in control. 

We have patented a device 
that protects your software 
while allowing unlimited 
archival copies and unin- 
hibited use of hard disks and 
LANs. The name of this 
product is The BLOCK™ 

The BLOCK is the only 
patented method we know 
of to protect your investment. 
It answers all the complaints 
of reasonable people con- 
cerning software protection. 


In reality, the only people 
who could object are those 
who would like the option 
of stealing your company’s 
product. 


‘...eliminating the ratio- 
nale for copy-busting...”’ 


Since The BLOCK allows 
a user to make unlimited 
archival copies the rationale 
for copy-busting programs 
is eliminated. 

The BLOCK is fully pro- 
tected by federal patent law 
rather than the less effective 
copyright statutes. The law 
clearly prohibits the produc- 
tion of work-alike devices 
to replace The BLOCK. 


The BLOCK attaches to 
any Communications port of 
virtually any microcomputer. 
It comes with a unique 
customer product number 
programmed into the circuit. 

The BLOCK is transpar- 
ent to any device attached to 
the port. Once it is in place 
users are essentially unaware 
of its presence. The BLOCK 
may be daisy-chained to 
provide security for more 
than one software package. 

Each software developer 
devises their own procedure 
for accessing The BLOCK 
to confirm a legitimate user. 
If it is not present, then the 
program can take appro- 
priate action. 


“*,.. possibilities... 
limited only by your 
imagination...” 


The elegance of The 
BLOCK lies in its simplicity. 
Once you understand the 
principle of The BLOCK, 
hundreds of possibilities will 
manifest themselves, limited 
only by your imagination. 

Your efforts, investments 
and intellectual property 
belong to you, and you have 
an obligation to protect 
them. Let us help you safe- 
guard what’s rightfully yours. 
Call today for our brochure, 
or a demo unit.” 





oftware 


wtf, 


ecurily 
870 High Ridge Road Stamford. Connecticut 


inc. 
06905 


203 329 8870 
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Advanced Screen Manager 


Building an interactive application 
in C? PANEL Plus provides the 
features you need for professional 
program development: 


PRODUCTIVITY 


The PANEL Plus interactive screen 
design tools are the fastest way to 
get your application screens set out 
and tested. Just type prompts on 
the screen, mark out entry fields, 
define display and entry attributes, 
help boxes, borders, pop-up areas. 
Fields can be edited, moved and 
resized, and validation details 
entered — with the screen displayed 
so that you can see the effect of 
your changes. 


Then PANEL Plus saves your work 
to disk, from where you can either 
load the design directly into your 
application program, or for better 
control, automatically generate C 
data structures, field areas, and 
header files which are compiled 
and linked into your program. 


PANEL Plus screens can include 
all the features demanded by 
today’s applications. Several 
different menu types are provided, 
including highlighted bars with 
help lines. Easy-to-use library 
functions support pop-up fields, 
horizontal and vertical scrolling in 
a field, and validation exits for 
supplied or custom data checking 


functions. Text functions can also . 


be carried out in graphics mode 
using a supported graphics 
function library. 
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Although the library contains over 
150 functions, it is logically 
organised so that most programs 


will only need to use a small subset. 


Users of Roundhill’s PANEL 
package will find that the old calls 
have been emulated (and all 
screens are compatible). New, 
expanded documentation is 
provided with examples of all the 
main function calls. PANEL Plus 
includes full library source, with 
variant files for all supported 
systems, and no royalties are 
payable for the use of PANEL Plus 
libraries when linked into user 
applications. 


PORTABILITY 


PANEL Plus is designed to allow 
your programs to be ported to just 
about any environment where you 
can find a C compiler. Every 
version of PANEL Pius includes 
source modules for interfacing to 
all of the following environments: 
MS-DOS/PC-DOS (portable and 
memory-mapped), OS/2 protected 
mode, Amiga Intuition, Unix (with 
and without termcap or termio), 
Xenix, DOS-J (including Asian 


Roundhill Computer Systems Limited 
PO Box 8107, Englewood NJ 07631 


Roundhill Computer Systems Limited 


New! 


Roundhill announces two screen 
tools for use with the exciting new 
C compilers from Borland and 
Microsoft: 


PANEL/TC — $129.00 
For use with Borland’s Turbo C 


PANEL/QC — $129.00 
For use with Microsoft’s Quick C 


Each package is configured for 
use on an IBM PC or compatible 
system, and screens can be 
designed and built into your 
programs while running in the 


special development environment 
provided with the compiler. 


All the PANEL Plus library 
functions are supported, and 
source code for every validation 
function is provided so that you 
can customise the entry checking 
to suit your application. When 
you need to move your programs 
to other environments, or need 
the full library source for other 
reasons, upgrades to PANEL Plus 
are available. 

PANEL/QC can be run in any of 
the graphics modes supported by 


Quick C, and also interfaces to 
Microsoft C V5. 





16-bit character editing), and 
VAX/VMS. Graphics libraries 
supported include MetaWindow, 
HALO, Essential Graphics, and 
Microsoft C V5. The Microsoft 
mouse can be used in PC versions. 


PANEL Plus for MS-DOS, with full 
library source, is priced at $495.00. 
Versions are available for the 
Manx Aztec, Borland, Lattice, 
MetaWare, Microsoft, and Wizard 
C compilers. Please call for prices 
of PANEL Plus for Xenix and Unix 
systems, and for VAX/VMS. 
Existing registered users of 
PANEL will receive a credit 
against the PANEL Plus license fee. 


(201) 569 2265 


(0672) 54675 


PO Box 14 Marlborough SN8 1LR England 


Telex (UK): 
Fax (UK): 


444453 AWARE G 
(0672) 54436 
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Roundhill Computer Systems 





Listing One (Listing continued, text begins on page 30.) 


25: 


26: 


28: 


29: 


30: 


Si: 


32: 


so 


34: 


358 


36: 


END; 
END; 
END; 


TriggerEnabled := True; {enable trigger} 


BEGIN {Stop Triggering} 
TriggerEnabled := False; 
{stop triggering for both channels} 
COM1_ Is Triggered := False; 
COM2_ Is Triggered := False; 


{start data display for both channels} 

COM1_ Display Data := True; 

SOM2_ Display Data := True; 

GoToOXY (3,25); 

C1rEol; 

WriteString{’Triggering Disabled’ ,Low); 
END; 


: BEGIN {Ascii Normal Data Display} 


AsciiDisplay := True; 
HandShakeDisplay := False; 
END; 


BEGIN {Ascii with handshake Data Display} 
AsciiDispla: := True; 
HandShakeDifplay := True; 

END; 


BEGIN {Hex Normal Data Display} 
AsciiDisplay := False; 
HandShakeDisplay := False; 

END; 


BEGIN {Hex with handshake Data Display} 
AsciiDisplay := False; 
HandShakeDisplay := True; 

END; 


BEGIN {Toggle adding spaces to display} 
AddSpace := NOT AddSpace; 
END; 


BEGIN {Start data acquire} 
COM1_Data_ Acquire := True; 
COM2_Data_ Acquire := True; 

END; 


BEGIN {Stop data acquire} 
COM1_ Data Acquire := False; 
COM2_ Data Acquire := False; 

END; 


BEGIN {Clear the display} 
{claim the screen} 
Alloc(ScreenAccess) ; 
Cirscer; 
DrawMenuFrame; 
{set cursor postion to home} 
OldxXPos := 1; 
OldyYPos := 1; 
Dealloc(ScreenAccess) ; 

END; 


Init_Program; {reset the analyzer} 


BEGIN {End the analyzer program} 
ExitMenu := True; 
ExitProgram := True; 

END; 


{***kekeHKKKK Begin Task Procedures *tttkekteeken} 


PROCEDURE ProcessKeysTask; 


VAR 


Ch: Char; 


Done, 


OldCOMI1Flag, 
OldCOM2Flag: Boolean; 


BEGIN 


Done 


:= False; 


REPEAT 


{read key if available else yield} 


Ch := Char (GetKey); 
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CASE Ch OF 


Esc: BEGIN {if key is Esc} 
{display and process the menu} 
Done := DoMenu; 
{rebuild display when finished} 
BuildDisplay; 
END; 


Sp: BEGIN {if space bar} 
{save old state} 
OldCOM1Flag := COM1 Display Data; 
OldCOM2Flag := COM2 Display Data; 


{stop filling of the display fifo so} 
{it does not overflow durin pause} 
{turn off display data both channeis} 
COM1 Display Data := False; 
COM2_ Display Data := False; 
GoToxy (1,24); 
ClrEol; 
GoToxY (23,24); 
WriteString ( 
‘Press <Enter> to restart the display’ 
»HighBlink) ; 
REPEAT 
{loop until Cr starts display again} 
Ch := Char (GetKey) ; 
UNTIL Ch = Cr; 


{restore previous display status} 
COM1 Display Data := OldCOMIFlag; 
COM2_ Display Data := OldCOM2Flag; 
BuildDisplay; {rebuild display} 
END; 
END; 


UNTIL Done; 


END; 


PROCEDURE MoveCOM1Data; 


{Move data from the COMl input buffer to the} 
{COM2 output buffer and to the display buffer} 
{if enabled} 


VAR 


Sd: DataRec; 
Dd: DisplayRec; 


BEGIN 


REPEAT 
{yield if no data to move} 
WHILE COM1 Input _Fifo.Ovd.Count = 0 DO 
yield; 
{when data is available move it} 


{turn ints off, read data, turn ints on} 
INLINE (SFA) ; 

GetSerialData(COMl Input _Fifo,Sd); 
INLINE (SFB); 


{store in COM2 output fifo} 
PutSerialData(Sd,COM2_ Output _Fifo); 


{if a trigger is enabled} 
IF COM1 Is Triggered AND 
TriggerEnabled THEN 
BEGIN 
{and a match is found} 
IF Sd.Data = TriggerPattern THEN 
{indicate match & disable further matches} 
{trigger is single shot event} 
BEGIN 
TriggerEnabled := False; 


WriteStringAt (’ COM1 Triggered 
, LOW, 3,25); 

{If displaying before trigger} 
{then stop data display} 
IF TriggerMode = Before THEN 

COM1 Display Data := False 
ELSE 

{start the data display} 

COM1 Display Data := True; 


END; 
END; 


(continued on next page) 
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PROTOCOL ANALYZER 


Listing One (Listing continued, text begins on page 30.) 


{if we are displaying data} 
IF COM1 Display Data THEN 
{move data to the display fifo also} 
BEGIN 
{tagged from this COM device} 
Dd.DR := Sd; 
Dd.Tag := FromcOMl; 
PutDisplayData (Dd,DisplayFifo) ; 
END; 


UNTIL False; 


END; 


PROCEDURE MoveCOM2Data; 


{Move data from the COM2 input buffer to the} 
{COM1 output buffer and to the display buffer} 
{if enabled} 


VAR 


Sd: DataRec; 
Dd: DisplayRec; 


BEGIN 


REPEAT 
{yield if no data to move} 
WHILE COM2 Input_Fifo.Ovd.Count = 0 DO 
yield; 


{when data is available move it} 


{ints off, read data, turn ints on} 
INLINE ($FA) ; 
GetSerialData(COM2_Input_Fifo,Sd); 
INLINE (SFB); 


{store data in COM1 output fifo} 
PutSerialData(Sd,COMl Output_Fifo); 











{if a trigger is enabled} 
IF COM2_ Is Triggered AND 
TriggerEnabled THEN 
BEGIN 
{indicate match & disable further matches} 
{trigger is single shot event} 
IF Sd.Data = TriggerPattern THEN 
BEGIN 
TriggerEnabled := False; 
WriteStringAt (’ COM2 Triggered 
Low, 3,25); 
{If displaying before trigger} 
{stop data display} 
IF TriggerMode = Before THEN 
COM2 Display Data := False 
ELSE 
{If displaying after trigger} 
{start data display} 
COM2_Display Data := True; 


END; 

END; 

{if we are displaying data} 

IF COM2 Display Data THEN 

BEGIN 
{move data to the display fifo also} 
Dd.DR := Sd; 


{tagged from this COM device} 
Dd.Tag := FromCOM2; 
PutDisplayData (Dd,DisplayFifo); 
END; 
UNTIL False; 


END; 


PROCEDURE OutputCOM1Data; 


{Move serial data from the output fifo} 
{to the COM port} 


(continued on page 62) 





ADD TO THE POWER OF YOUR PROGRAMS WHILE YOU SAVE TIME AND MONEY! 


CBTREE does it all! Your best value in a B+tree source! 


Save programming time and effort. 

You can develop exciting file access programs quickly and easily because 
CBTREE provides a simple but powerful program interface to all B+tree 
operations. Every aspect of CBTREE is covered thoroughly in the 80 page 


Users Manual with complete examples. Sample programs are provided on 
disk. 


Gain flexibility in designing your applications. 

CBTREE lets you use multiple keys, variable key lengths, concatenated 
keys, and any data record size and record length. You can customize the 
B+tree parameters using utilities provided. 


Your programs will be using the most efficient searching techniques. 
CBTREE provides the fastest keyed file access performance, 
with multiple indexes in a single file and crash recovery utilities. 
CBTREE is a full function implementation of the industry 
standard B+tree access method and is proven in applications 
since 1984. 


Access any record or group of records by: 
* Get first 

* Get previous 

* Get less than 

« Get greater than 

* Get sequential block 

* Get all partial matches 

* Insert key and record 

* Delete key and record 

* Change record location 


° Get last 

* Get next 

* Get less than or equal 

* Get greater than or equal 
* Get partial key match 
Get all keys and locations 
* Insert key 


* Delete key 


Increase your implementation productivity. 
CBTREE is over 8,000 lines of tightly written, commented C source code. 
The driver module is only 20K and links into your programs. 


Port your applications to other machine environments. 

The C source code that you receive can be compiled on all popular Cc 
compilers for the IBM PC and also under Unix, Xenix, and AmigaDos! No 
royalties on your applications that use CBTREE. CBTREE supports multi- 
user and network applications. 


CBTREE IS TROUBLE-FREE, BUT IF YOU NEED HELP WE PROVIDE FREE PHONE SUPPORT. 
ONE CALL GETS YOU THE ANSWER TO ANY QUESTION! 





Cre Es 2 y 
PEACOCK SYSTEMS, INC. 


CBTREE compares favorably with other software selling at 2,3 and 4 times our price. 
Sold on unconditional money-back guarantee. 
YOU PAY ONLY $159- A MONEY-SAVING PRICE! 
TO ORDER OR FOR ADDITIONAL INFORMATION 
CALL 1-800-346-8038 or (703) 847-1743 
OR WRITE 


NOW! Variable length records. 


NEW! --- Limited Time Offer. 
Object Library for Only $49! 


Peacock Systems, Inc., 2108-C Gallows Road, Vienna, VA 22180 
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“Developing my application in C would have taken 6 months to a year, but in Actor it took 2 


months.” —Brian Fenske, Boeing Commercial Airplane Company 





Actually, you don’t have to make the 
ae } O : ACIOR choice. Once C was ideal for all PC pro- 


gramming. But it has been complicated by 


oO windowing and graphical interfaces. Now 

Or not windows development with C is difficult, 
39 time-consuming and error-prone. You 

to C eee need a new language that simplifies win- 


dows programming. Introducing Actor® 


Actor is the first interactive object-oriented language made for commercial development. 
Its powerful browsers, inspectors and debuggers give you more insight into a windowing 
environment than C ever will. But your C work is not lost. C libraries can be linked to Actor. 
Plus, its procedural syntax is easy for C programmers to learn. 


Actor comes with windowing classes built in. Customize Actor’s classes to create stand- 
alone windowing applications. And objects give you another layer of independence for a 
smooth transition to OS/2 and Presentation Manager. It’s the quickest and easiest way to write 
a windowing program. 


“You can write Windows programs much faster with Actor than with C or assembly language. ” 
—PC Magazine, June 9, 1987 


Te cih Specs 





Actor $495 ¢ Academic price $99 ¢ Academic site license $99 ¢ Manuals for site 
license $35 « New! Language Extension $99 Shipping $5 US, $25 Int’l 


The Whitewater Group 
Technology Innovation Center 
906 University Place, Evanston, Illinois 60201 


(312) 491-2370 
Actor is a registered trademark of The Whitewater Group, Inc. | 
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Listing One (Listing continued, text begins on page 30.) 


CONST 


{max of 80 chars to serial port} 
{between yields to other “<asks} 


OutputsPerYield = 80; 


VAR 
Outs: Integer; 
Sd: DataRec; 


Urgent: Boolean; 
BEGIN 
REPEAT 


{do until data is available in fifo} 
WHILE (COM1 Output_Fifo.Ovd.Count = 0) DO 
BEGIN 
{always make the handshake lines} 
{between COM1 and COM2 agree then yield} 
MakeHandshake (COM1,COM2_ Status); 
yield; 
END; 


{we have data to output} 
{Its urgent if fifo is over half full} 


Urgent := (COM1_Output_Fifo.Ovd.Count >= 
(SerialDataFifosize/2)); 


{Initialize output counter to max value} 
Outs := OCutputsPerYield; 


{While there is data to output} 


WHILE ((COM1_Output_Fifo.Ovd.Count <> 0) AND 
(Outs <> 0)) DO 
BEGIN 


{test if UART is ready to transmit} 


WHILE (Get_Serial_Status(COM1) AND 
TxRdyBit) = 0 DO 
BEGIN 
{if we have time yield until ready} 
If NOT Urgent THEN 
yield; 
END; 


{get data record to output } 

{set the handshake lines and output} 
{the data} 
GetSerialData(COMl_Output_Fifo,Sd); 
MakeHandshake (COM1,Sd.Status); 

port [(COMl] := Sd.Data; 


{one less to output} 
Outs := Outs - l; 


END; 
yield; 


UNTIL False; 


END; 
PROCEDURE OutputCOM2Data; 


{Move serial data from the output fifo} 
{to the COM port} 


CONST 


{max of 80 chars to serial port} 
{between yields to other tasks} 


OutputsPerYield = 80; 


VAR 
Outs: Integer; 
Sd: DataRec; 


Urgent: Boolean; 
BEGIN 


REPEAT 


{do until data is available in fifo} 
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WHILE (COM2 Output _Fifo.Ovd.Count = 0) DO 
BEGIN 
{always make the handshake line} 
{between COMl1 and COM2 agree then yield} 
MakeHandshake (COM2,COM1 Status); 
yield; zs 
END; 


{we have data to output} 
{Its urgent if fifo is over half full} 


Urgent := (COM2 Output_Fifo.Ovd.Count >= 
(SerialDataFifoSize/2)); 


{Initialize output counter to max value} 
Outs := OutputsPerYield; 


{While there is data to output} 


WHILE ((COM2_ Output _Fifo.Ovd.Count <> 0) AND 
(Outs <> 0)) DO 
BEGIN 
{test if UART is ready to transmit} 


WHILE (Get_Serial_ Status(COM2) AND 
TxRdyBit) = 0 DO 
BEGIN 
{if we have time yield until ready} 
IF NOT Urgent THEN 
yield; 
END; 


{get data record to output} 

{set the handshake lines and output} 
{the data} 
GetSerialData(COM2_Output_Fifo,Sd); 
MakeHandshake (COM2,Sd.Status) ; 
port[COM2] := Sd.Data; 


{one less to output} 
Outs := Outs - 1; 


END; 
yield; 


UNTIL False; 


END; 


PROCEDURE DisplayCOMData; 
CONST 
{max # of items displayed before yielding} 


MaxDisplayItems = 20; 


VAR 
DisplayItems, 
DataLen: Integer; 
D: DisplayRec; 
BEGIN 


{initial cursor is homed} 
{in data display window} 
OldxPos := 1; 
OldyYPos := 1; 


REPEAT 

{if data in display fifo} 

IF DisplayFifo.Ovd.Count <> 0 THEN 

BEGIN 
{claim the screen, define the window} 
{position the cursor and initialize} 
{items counter} 
Alloc(ScreenAccess); 
Window(1,7,80,23); 
GoToxXY (O1dXPos,OldyYPos); 
DisplayItems := MaxDisplayItems; 


WHILE ((DisplayFifo.Ovd.Count <> 0 ) AND 
(DisplayItems <> 0)) DO 
{while there is data to display} 
BEGIN 
{get the data, display it, dec} 
{item counter. Save len of displayed} 
{item. } 


GetDisplayData(DispiayFifo,D); 
DataLen := DisplayData(D); 
DisplayItems := DisplayItems ~ 1; 


(continued on page 65) 
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“PROTOCOL, 


Listing One (Listing continued, text begins on page 30.) 


{if not room to display for another} 
{item of same length and we’re on the} 
{last display line in window, then} 
{home cursor and start overwriting} 
{screen so as to avoid the scroll of} 
{the display. If not on last line of} 
{window, advance to next line. Either} 
{way, the next line must be cleared.} 


IF WhereX + DataLen >= 80 THEN 
IF WhereY = 17 THEN 
GoToxYy/{1,1) 
ELSE 
WriteLn; 


ClrEol; 
END; 


{save new cursor position} 
OldxXPos := Wherex; 
OldYPos := WhereyY; 


{back to full screen} 
{and release screen lock and yield} 
Window (1,1,80,25); 
Dealloc(ScreenAccess) ; 

END 

ELSE 
{if no data to display just yield} 
yield; 


UNTIL False; 


END; 


PROCEDURE Timer; 


VAR 


Toggle: Boolean; 


BEGIN 


Toggle := True; 
REPEAT 


{every 1/2 second do the following} 
pause (4); 


{if ok to update the screen} 
IF UpdateScreenStatus THEN 
BEGIN 
{lock the screen} 
Alloc(ScreenAccess) ; 


{if status of either port has changed} 
IF ((COM1_ Status <> O1dCOM1 Status) OR 
(COM2 Status <> O1dCcOM2 Status) ) THEN 


{then update the screen} 
BEGIN 
{display new COM1 status} 
DisplayHandShakeStatus (COM1,COM1 Status 
,COM2 Status); 
{save new status} 
OldCOM1 Status := COM] Status; 


{display new COM2 status} 
DisplayHandShakeStatus (COM2,COM2 Status 

,COM1 Status); 
OldCOM2 Status := COM2_ Status; 


END; 

{every full second update} 

{buffer status on screen} 

IF Toggle THEN 
DisplayBufferStatus; 


{unlock the screen} 
Dealloc (ScreenAccess); 


Toggle := NOT Toggle; 
END; 
UNTIL False; 


END; 


(continued on page 46) 
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“The overall efficiency of my 
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cantly improved.” 


William G. Harrington, 
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June 29, 1987, Page 14. 
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Listing One (Listing continued, text begins on page 30.) 


BEGIN {main} 


{verify presence of COMl1 and COM2} 
VerifyHardware; 


{initialize the multitasker} 
Init_Kernel; 


{initialize the menu structure} 
Init _Menu; 


{install the serial ISRs} 
Install Serial _ Handlers; 


{Initialize strings used to format the display} 

Linel := Char(201)+’ COM1 ’+repl(16,Char(205))+ 
‘ Serial Protocol Analyzer Ver: 1.0 ’+ 
repl(15,Char(205))+ % COM2 ’+Char(187); 


Line2 := Char(186)+’ In Fifo:’+repl(5,’ ’)+ 
“Out Fifo: "+ Char (186)+ 
repl(10,’ ’)+’By’+repl(10,’ ’)+ 
Char(186)+’ In Fifo:’+repl(5,’ ’)+ 
‘Out Fifo: ’+Char (186); 


Line3 := Char(186)+’ Stat- BRK: FE: PE: OR: ’+ 
Char (186)+ ’ Craig A. Lindley "+ 
Char (186)+ ’ Stat- BRK: FE: PE: OR: ‘+ 
Char (186); 


Line4 := Char(186)+’ In - CD: RI: DSR: CTS: ‘+ 
Char (186)+repl(22,’ ’)+Char(186)+ 
*- In =. Cpe. RI: DSR: CTS: °+Char (186) >; 


Line5 := Char(186)+ ’ Out- DTR: RTS:'’+ 
repl(7,’ ’)+Char(186)+ 
7 Display Fifo: ’+Char (186) + 
’ Out- DTR: RTS:’¢+repl(7,’ °’)+ 
Char (186); 

Line6 := Char(200)+repl(27,Char(205))+ 
Char (202) +repl (22, Char (205))+ 
Char (202) +repl(27,Char(205))+ 
Char (188); 


Line24 := ’ <Esc> for Menu <Space Bar> to Pause’t+ 
if COM1 - Normal : COM2 - Reverse Video’; 


BuildDisplay; {show main display} 
Init_Program; {initialize all vars} 


{initialize screen lock} 
Initialize Semaphore (ScreenAccess) ; 


{enable status update} 
UpdateScreenStatus:= True; 


{Fork off all tasks} 
Fork; 


IF child_process THEN 
MoveCOM1Data; 


Fork; 


IF child_process THEN 
MoveCOM2Data; 


Fork; 


IF child_process THEN 
OutputCOM1Data; 


Fork; 


IF child_process THEN 
OutputCOM2Data; 


Fork; 


IF child_process THEN 
DisplayCOMData; 


Fork; 

IF child_process THEN 
Timer; 

ProcessKeysTask; 

Clirser; 


Disable Serial Devices; 
Remove Serial Handlers; 


END End Listing One 
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e e 
Listing Two 
{ EXKKKKKAKKKKEKKKKKEKKEKKEKKEKKKEKKKKKEKKKKEKKEKKKKEEE | 
{**x* ak) 
(=45 Menu System support procedures a | 
{*** for the serial protocol analyzer kak} 
{*** written by ee} 
{**® Craig A. Lindley xe) 
{*** kke} 
{*** Ver: 2.0 Last update: 08/15/87 eee} 
{*** axe} 


{RRR RRR RRR RRR RRR IRR RRR RIKKI IRR KI Y 
CONST 


{max # of video attributes - 1} 
AttribMax = 5; 


Attributes: ARRAY[0..AttribMax] OF 


RECORD 
f, {foreground color} 
b: Integer; {background color} 
END 


{Attributes are:} 
{Low, High, Rev, LowBlink, HighBlink, RevBlink} 


= ((£:7:; b:0) , (£:15:b30) , 4£:02 bt7)~ 
(£252335b:0)", (E:3lsbe0): p°tE 16 eb:7):) 3 


{menu display lines relative to screen line 1} 
MenuLinel = 2; 
MenuLine2 = 3; 
MenuLine3 = 4; 
MenuLine4 = 5; 


{max A tree dimensions} 
level2width = 7; 


level3width = 5; 

level4width = 7; 

home= #199; {home key code} 

larrow= #203; {left cursor arrow code} 
rarrow= #205; {right cursor arrow code} 
endkey= #207; {end key code} 

bs= #08; {backspace key} 

1f= #10; {line feed code} 

cr= #13; {carrage return code} 
Esc= #27; {escape key code} 

sp= #32; {ascii space code} 
TYPE 


AttribType = (Low ,High, Rev, LowBlink, 
HighBlink, RevBlink); 


{data structure for atree menu entry} 
{see text for details} 


menu_entry= 

RECORD 
title: STRING[10]; 
desc: STRING[40]; 
chars: STRING[8]; 
index: Byte; 
ccode: Byte; 

END; 


tree = ARRAY[(0..level2width, 
0..level3width, 
0..level4width] 

OF menu_entry; 


VAR 


ExitMenu, 
ExitProgram: Boolean; 


indl,ind2, 

ind3, 

selector, 

cmd_code, 

level: Byte; 


{atree data structure used for nested menus} 
atree: tree; 


{****x*x** Keyboard and Display Procedures ********} 


PROCEDURE Beep; 


(continued on page 68) 
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I have come to bury 
C sir, not to ¥ 
praise It. 


C served us well in the days of kilobytes and kilohertz. It was the only 
language we could implement efficiently on our newborn microcom- 
puters. But with today’s mega-machines, shouldn't we demand more 
from our compilers? 

Modula-2 increases productivity by catching your errors at compile 
time. You'll easily modularize and structure your programs, driving the 
hordes of barbaric bugs into the hinterlands. And Modula-2 does all 
this without taking away the low-level machine access that made C so 
popular. 

Until now, you had to pay a price for the Modula-2 advantages — per- 
formance just didn’t measure up to C But we've changed all that. In 
a suite of benchmarks developed by PC Week: 






















Ai 


Stony Brook Modula-2 outperforms 
the best C compilers on the market 


(and no other Modula-2 compiler even comes close). 


Stony Brook Modula-2, for 80x86 machines, produces Microsoft-compatible 
objects, and fully supports both Microsoft Windows and OS/2. It’s the only high- 
level language compiler that lets you write dynamic link libraries. It handles 32- 
and 64-bit real numbers with in-line 80x87 coprocessor instructions or software 
emulation. And Stony Brook Modula-2 supports six memory models and mixed 
model programming. 


You might want to bury your C compiler 
once you have used Stony Brook Modula-2, but 
you won't have to. We made it possible to 


. Stony Brook Logitech Turbo Microsoft 
directly call C and other lanquages from y : 




















Eee M-2 V1 M-2V3 CV1 C V4 

Modula-2, so you won't have to throw away Magnifier 005 O06 005 00 
your investment in C code. For Loop 0.28 0.73 0.44 0.68 
While Loop 0.35 0.75 0.49 0.66 
Repeat Loop 0.33 0.68 0.38 0.66 
S Literal Assign 0.33 0.97 0.60 0.94 
_ friends, programmers, and C- rs, lend us Memory Access 0.33 1.04 0.55 1.00 
iia en Ae ‘ 2 _ ae " Real Arithmetic 4.68 13.40 373 2.96 
your ears. Call us or write for more information Real Algebra 4.18 12.87 3.07 3.64 
; Vector 0.77 1.75 1.21 1.26 
and to find out how you can get a demo Equal If 0.66 14a7 0:93 132 
compiler. Unequal If 0.66 1.43 0.99 1.32 
No Parameters 0.33 0.60 0.34 1.04 
Value 0.50 0.71 0.60 1.21 
ase reference 0.61 0.77 0.66 1.21 
eae 3.90 4.61 7.85 18.51 





<~aee Real Maths ; ; : : a 
) ia , 
The compiler package includes DOS runtime library objects and full sources 









tov'y for our split-screen text editor for $195. The development package includes all 
INJC. of the above pius an automatic make utility, a symbolic debugger, and run- 
time library sources for $345. MasterCard and Visa accepted. Add $5 for ship- 
SOFT WAR E ping in North America, $25 for overseas shipping. 


Forest Road, Wilton, New Hampshire 03086 @ (603)654-2525 Ask for Cleopatra. 
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Listing Two (Listing continued text begins on page 30.) 


BEGIN 


Sound (1000); 
Pause(l); 
NoSound; 


END; 


FUNCTION GetKey : Byte; 
VAR 


Ch: Char; 
B: Byte; 


Currentx, 
Currenty: Integer; 


BEGIN 


{save cursor position} 
{because we are going to yield} 
{and loose control of display} 


CurrentX := Wherex; 
CurrentYy := Wherey; 


{yield until a key is pressed} 


WHILE NOT keypressed DO 
yield ; 


{put the cursor back} 
GoToXyY (CurrentX, Currenty) ; 


{read the key} 
read (kbd, Ch); 


{see if its an extended key} 
IF (Ch = Esc) AND keypressed THEN 
BEGIN 
{if so read again and mark} 
{as extended by setting MSB} 
read (kbd, Ch); 
B := ord(Ch)+128; 
END 
ELSE 
{in either case B has key code} 
B := ord(Ch); 


GetKey := B; 


END; 


FUNCTION repl (Count:Integer; ch:Char) :FullString; 


{replicate a char into a string of} 
{specified length} 


VAR 
i Integer; 
BEGIN 


FOR i:=l1 TO Count DO repl[i] :=ch; 
repl1 [0] :=Char (Count) ; 


END; 


PROCEDURE WriteString (Stng:FullString; 
Attrib:AttribType) ; 


BEGIN 


{set the foreground and background} 
{colors and write the string} 


WITH Attributes [ORD(Attrib)] DO 
BEGIN 
TextColor(f); 
TextBackGround (b); 
END; 
write (Stng); 


{go back to low video mode} 
WITH Attributes [ORD(Low)] DO 


BEGIN 
TextColor(f); 
TextBackGround (b); 
END; 
END; 
PROCEDURE WriteStringAt (Stng:FullString; 
Attrib:AttribType; 
X,Y: Integer) ; 
BEGIN 


GoToxY (X,Y); 
WriteString(Stng,Attrib); 


END; 


{ FXKRRKKKKKK Start of Menu Procedures REKKKKKKKKK) 

PROCEDURE center (Line,Width: Integer; 
Outstr:FullString; 
Attrib:AttribType) ; 


{Center and write string with attribute on a} 
{specified line in a given width field} 


BEGIN 
GoToxyY (1, Line) ; 
Clreol; 
GoToXY( (Width DIV 2)-(length(Outstr) DIV 2), 
Line) ; 
WriteString(Outstr,Attrib) ; 


END; 


PROCEDURE DrawFrame (x,y,width, height: Integer) ; 
VAR 
top, bottom: Strso; 

BEGIN 
top:= repl (width, Char (205)); 
bottom:=repl (width, Char (205)); 
WriteStringAt (top, High,x,y); 
WriteStringAt (bottom, High, x, ytheight-1) ; 


END; 


PROCEDURE DrawMenuFrame; 
BEGIN 
DrawFrame(1,1,80,6); 
center (MenuLinel, 78, 
’ Serial Protocol Analyzer Menu ’,Rev); 
END; 


PROCEDURE DisplayMenu (ind1l,ind2,ind3,level, 
selector :Byte); 


VAR 
tindl,tind2, 
tind3,i: Integer; 
attrib: AttribType; 
titlestr: FullString; 
BEGIN 


titlestr:=’-- ’+ 
atree[indl,ind2,ind3].titlet+’ Selection’+’ --’; 
center (MenuLine2,78,titlestr, Low); 
GoToxyY (1,MenuLine4) ; 
clreol; 
GoToxyY (9, MenuLine3) ; 
clreol; 


FOR i:= 1 TO atree[indl, ind2,ind3].index DO 


BEGIN 
CASE level OF 
1: indl:=i; 
2: ind2:=i; 


(continued on page 72) 
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Clarify and document your source listing and get 





an “organization chart” of your program’s structure 


with two NEW utilities from Aldebaran Laboratories, for C, BASIC, | 
Pascal, (BASE® FORTRAN and Modula-2 programmers 


“Occasionally, a utility 
comes along that makes a 
programmer’s life much 
easier. SOURCE PRINT 
is such a program. 

It contributes to the 
programmer’s job by 
organizing code into a 
legible format and by 
helping to organize the 
documentation and 
debugging process.” 


— PC Magazine 
Sept. 16, 1986 


Source Print and Tree Dia- 
grammer both have easy-to-use 
menus with point-and-shoot file 
selection, and let you search for 
files containing a given string. 
For IBM PC and compatibles 
with 256K. 

Join thousands of program- 
mers who are working more 
efficiently using Source Print 
and Tree Diagrammer. Order 
these indispensable tools today. 
We ship immediately, and 
there’s no risk with our 60-day 
money-back guarantee. Order 
both and save. Only $155.00. 


800-257-5773 bdept.ss 


In California: 


800-2 5 7-9 is 74 Dept. 58 


MasterCard, VISA, American 
Express, COD. Add $5 for 
shipping/handling. 


or see your local dealer! 


Source Print and Tree Diagrammer are 
trademarks of Aldebaran Labs. dBASE is 
a trademark of Ashton Tate. Prices subject 
to change without notice. 


04-06-86 13:45:44 dem}.prg 
Sun 04-06-86 13:47:57 











Source Print” 


organizes your source code, simpli- 
fies debugging, and makes documen- 
tation a snap! It lists one or more 
source files with informative page 
headings and op- 
tional line numbers, 
while offering 
invaluable features: 

The Index 
(Cross-Reference 
list) saves you time 
by showing exactly 
where variables are 
used and where functions, pro- 
cedures, and routines are called. 
Locations where new 
values may be assigned to 
variables are shown, making it easy to track down that 
mysterious value change. 

Structure Outlining solves the problem of hard-to- 
see nested control structures by automatically drawing 
lines around them. 

Automatic Indentation of source code and listings 
reduces your editing time and ensures indentation accuracy. 
Plus... Source Print generates a table of contents 
listing functions and procedures. Keywords can be printed 
in boldface on most printers. Multi-statement BASIC lines 

can be split for readability. Functions and procedures can 
be drawn by name from one or more source files to form a 
new file. 


Tree Diagrammer” 


shows your program’s overall organization at a 
glance. Ordinary program listings merely display 
functions, procedures, and subroutines sequen- 
tially, but do not display the relationships be- 
tween these routines. Our revolutionary new 
Tree Diagrammer automatically creates an 
“organization chart” of your program showing the 
hierarchy of calls to functions, procedures, and 
subroutines. Recursive calls are indicated and 
designated comments in the source code 
will appear on the chart. 

Tree Diagrammer helps you organize your 
program more logically. And you’ll be amazed at 


how easy it is to debug when you $7 790 






150 FOR INDX = 1 TO 100 

160 IF TB(INDX) = 0 THEN X = 5 

170 C = 50: WHILE K <= 1000: TB(K) = 0: K = K + X: WEND 
180 GOSUB 2000 

190 XT(C) = X: Ta(c) = K: C=C +i 

200 NEXT INDX 













—FOR INDX = 1 TO 100 
160 IF TB(INDX) = O THEN X = 5 


WHILE K <= 1000 
TB(K) = 0 
= — + X 





source () 
{ 
while (iar < nres && ares[iar][(0] == c) 


if ((d = ares({iar)j({1}) == 0) 


p = &(ares(iar)[(1)); 
while (d = *p) 
Ps: 
looptt; 
} 
ins 53.2293 53=2309 53=2319 53.2325 


54.2331 54.2332 54.2336 54=2346 
00 54.2354 54.2364 54.2365 54.2366 
intext 4.193 9=395 43.1796 43.1815 


43=1820 45=1902 
Index 






SCWO@ONIMUW Fe WN 


Wed 12-31-86 07:22:03 INDEX (Cross Ref) 
all identifiers 


~ 
- 


inrecord 4.191 9=396 19.825 19=826 
21.889 22.922 22.953 23=978 
23.990 





Tue 01-06-87 00:28:44 
01-06-87 00:05:14 5S. 





see how your routines interact. 


Aldebaran Laboratories 3339 Vincent Rd. Pleasant Hill, CA 94523 415-930-8966 


YES! Rush ME Source Print @ $97. ______ [] Tree Diagrammer @ $77. 
L}] Both $155. Ship/Handling $5. For CA add 6% tax ___ CT 

Name 

Company 

Address 
City... 
{[JCheckenclosed []VISA ([]MasterCard [] American Express 
Coc? Llc CU 


Signature a 2 


Zip 
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~ Your Complete Tool Set; 








_ You could easily 5] 








an lease 


Now you can lease your choice of the best 
compiler, editor, debugger, and general pur- 
Pose Mbrary otwhatever” = 
If your 2-year-old business generates 
$75K + per year in revenue, call about our 
software-only lease. _ se 
Another innovation from The Programmer's 
Shop. = ee 
Call a Software “Leasing Specialist.” __ 


386 Development Tools : 





386 Assembler/Linker PC $ 389 
386 Debug - by Phar Lap PC 3,429 
386/DOS Extender PC $ 919 
DESQview PS/2 PC 3 109 
F77L-EM - by Lahey MS Call 
High C - by Metaware PC Call 


OS/286 & 386 by Al Architects PC Call 


PANE Tale let-le[-s— 


APT - Active Prolog Tutor - build 
applications interactively PC $ 49 
ARITY Prolog - full, 4 Meg 





Interpreter - debug, C, ASM PC $ 229 
COMPILER/Interpreter-EXE PC $ 569 
Cogent Prolog Compiler MS $ 179 


MicroProlog Prof. Comp./Interp. MS $ 439 


PC Scheme LISP - by TI PC S85 
Star Sapphire MS $ 429 
TransLISP - learn fast MS $ 79 
TransLISP PLUS MS $ 149 
TURBO PROLOG by Borland PC $ 69 


Others: IQ LISP ($239), IQC LISP ($269) 
Basic 





BAS_C - economy MS $ 179 
BAS_PAS - economy. MS $ 135 
Basic Development Tools PC 3: 389 
db/Lib MS $ 119 
Exim Toolkit - full PC $ 45 
Finally - by Komputerwerks PC $ 85 
Inside Track PC $ 49 
Mach 2 by MicroHelp PC..3: 32 
NetWorks by Exim oe OM: SE 
QBase - screens MS $ 79 
QuickBASIC PC $ 69 


PC $59 
PC $ 109 
rie. a9 
True Basic PC: 3; 79 
Turbo BASIC - by Borland PC $ 69 
Turbo BASIC Database Toolbox MS $ 69 


FEATURES 


XQL - SQL for Btrieve callable from 
BASIC, C, and Pascal or for interactive 
query. Computed fields, specify sort 
order, manipulate composite records 
from joined files. No royalties. MS $459 


Instant-C/16M - Addresses up to 16M 
for program and data. Incremental 
compilation makes development 
faster than Turbo C (compile and relink 
XLISP in 4 secs vs 24). 286/386 
only. PC, List: $895 


Note: All prices subject to change without notice. Mention this ad. Some prices 
are specials. Ask about COD and POs. Formats: 3" laptop now available. plus 
200 others. UPS surface shipping add $3/item. 


Quick Pak-by Crescent Software 
Quick-Tools by BC Associates 
Stay-Res 





C Programmers: Complete 
Your Development Toolset. 


Dbase translation, fussy preprocessing, 
graphics windowing, ISAMs: C tools cover the 
spectrum. 


Select from the professional tools at right; or 
let us help you choose from over 100 others. 


Call one of our “tech reps” TODAY. 





RECENT DISCOVERY 


SofTRAN, the Translation and Text Lan- 
guage by TransOptima - full procedural 
language like C plus pattern and 
nonprocedural constructs cuts develop- 
ment effort by up to 16 times. PC $349 


C Language-Compilers 


AZTEC C86 - Commercial 
C86 PLUS - by Cl 


Datalight Optimum - C MS $ 99 
Lattice C - from Lattice MS $259 
Microsoft C 5.0- Codeview MS $275 
Microsoft Quick C MS $ 67 
Rex - C/86 standalone ROM MS $695 
Turbo C by Borland PC $ 67 


om Mil ele-1d(-t> als 


BTree by Soft Focus 

CBTREE - Source, no royalties 

ctree by Faircom - no royalties 

rtree - report generation 

dB2C Toolkit V2.0 

dbQUERY - ad hoc, SQL-based 

dbVISTA - Object only 
Source - Single user 

dBx - translator 


C-Screens, Windows, Graphics 


C Worthy Interface Library 

Curses by Aspen Scientific 

dBASE Graphics for C 

ESSENTIAL GRAPHICS - fast 

FontWINDOW/PLUS 

GraphiC - new color version 

Greenleaf Data Windows 
w/source 

Terminal Mapping System 






TurboWINDOW/C - for TurboC PC $ 75 
View Manager - by Blaise PC $199 
Windows for C - fast PC $149 
Windows for Data - validation PC $219 
Vitamin C - screen I/O PC $159 

VC Screen PC $ 79 
ZView - screen generator MS $149 


AtariST & Amiga 


We carry full lines of Manx & Lattice. 


1D) =¥-¥s) =m -laleler-le(— 


Clipper compiler 
dBASE II 
dBase III Plus 


Call for a catalog, literature, and solid value 


$(0)-421-8006 


BY 7 . 7B '4) QO ™ 
rHE PROGRAMMER 8 SHOP 


monionto 4 4 
= afte Ser = or lais 
CUNTNICLS C.oO0 UG lov" 





5-D Pond Park Road, Hingham, MA 02043 
Mass: 800-442-8070 or 617-740-2510 
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Order before February 29, 1988 and mention 
"DD288" for these SPECIAL PRICES: 


List 
$395 
$350 
$250 
$139 
$295 


SPECIAL 
$289 
$279 
$165 
$ 89 
$209 


Normal 
$315 
$299 
$185 
$119 
$239 


Ctree by Faircom 
dBx Translator 
Essential Graphics 
PC Lint 

Windows for Data 


RECENT DISCOVERY 


FORCE III, Dbase Compiler by Sophco - 
small .EXEs, user-defined functions, I/O 
directives through BIOS/DOS/ANSI/ 
FORCE /user-defined, extensions include 
FOR..NEXT loops, soundex, 1D arrays. 


Maverick. PC $109 
DB) =¥:Ns) =m Me laleler-le(-merelale 
dBASE III LANPack PC $649 


DBXL Interpreter by Word Tech PC $ 99 


FoxBASE+ Dev. - V2.0 MS $289 
Quicksilver by Word Tech PC $369 
DBASE Support 
dAnalyst PC $ 89 
dBase Tools for C PC $ 65 
dBrief with Brief PC Call 
dBC III by Lattice MS $169 
Documentor - dFlow superset MS $229 
Genifer by Bytel-code generator MS $279 
QuickCode III Plus MS $239 
R&R Report Writer MS $139 


Seek-It - Query-by-example PC 
Silver Comm Library MS 
Tom Rettig’s Library 5 
UI Programmer - user interfaces PC 


DataBase & File Management 





CQL PL 3.397 
DataFlex by Data Access PC $ 899 
DataFlex multiuser PC $1149 
Magic PC PC 5 699 
Paradox - original PC $ 369 
Paradox V2.0 PC $ 469 
Revelation by Cosmos PC $ 779 


TUL di E-lare [erste (-melel e) cleat 


BTRIEVE ISAM MS 
BTRIEVE/N-multiuser MS 
GSS Graphics Dev’t Toolkit PC 


HALO Development Package MS $389 
Graphics PS $209 
Help/Control - on line help PC $99 
Hoops Graphics Library PC $549 
Instant Programmer’s Help MS $ 79 


Informix 4GL-application builder PC 
Informix SQL - ANSI standard PC 
NET-TOOLS - NET-BIOS PC 


Opt Tech Sort - sort, merge MS $ 99 
Norton Guides PC $ 75 
Panel Plus MS $395 
Pfinish - by Phoenix MS $229 
Report Option - for Xtrieve MS $109 


Screen Sculptor PC 
SSP/PC - 145+ math routines PC 
Synergy - create userinterfaces MS 
Xtrieve - organize database MS 
ZAP Communications- VT 100 PC $ 89 









THE PROGRAMMERS SHOP 


provides complete information, advice, guarantees and every product for Microcomputer Programming. 


EXIM Se DEVELOPMENT 
TOOLKIT: | |e 


—_ 


LINK & LOCATE enables PC users to produce ROM-based 
firmware for 8086/87/186 from object files generated by 
popular C compilers, such as from Microsoft, Lattice and 
Borland’s Turbo C, and MASM from Microsoft, Provides full 
control of segment placement anywhere in memory. Sup- 
ports output of Intel HEX file for PROM programmers, Intel 
OMF absolute object file for symbolic debuggers and in- 
circuit emulators. Includes Intel compatible linker, locator, 
librarian, hex formatter and cross reference generator. $350. 


NEW! Includes utility to support PC based PROM 
programmers. 


* SYSTEMS & 
el SOFTWARE: * 


3303 Harbor Bivd., C11, Costa Mesa, CA 92626 


Phone (714) 241-8650 FAX (714)241-0377 TWX 910-695-0125 
CIRCLE NO. 142 ON READER SERVICE CARD 






































































ESSENTIAL BASIC 
PROGRAMMING TOOLS 


A must for all BASIC programmers who use 
Microsoft’s QuickBASIC or IBM’s PC BASIC com- 
pilers, our feature-rich, easy-to-use EXIM ToolKit 
provides dozens of useful routines unavailable in 
BASIC or any other single software library sold 
today! 

Here’s just some of what the EXIM ToolKit 
can do: 

With our Screen Management module, you 
get features like four-way scrolling, windowing and 
data entrydisplay in screen forms. You can also 
write to screen many times faster than with BASIC 
and develop software to copy areas of the screen for 
cut and paste functions. 

The multi-user Data Base Management 
module lets multiple users access the same data 
files across a local area network and still maintain 
data integrity. Users can build, add and delete 
indexes; reformat files and much more. Now BASIC 
users can control data as never before. 

The Network Interface modules make it 
possible for BASIC programs to issue NETBIOS 
commands. 

BASIC limits you to 64K of RAM for strings. 
EXIM ToolKit’s Memory Manager lets you 
access up to 256K additional RAM for strings. 
And, we offer free technical support, 7 days a week. 

Order your EXIM ToolKit today. It’s only 
$99.95, ($199.95 with Network Interface Modules) 
plus $5.00 shipping and handling. (Nolicensing or 
royalties required.) If within 30 days, you are not 
completely satisfied with the EXIM ToolKit, 
return it to your dealer for a complete refund. 


The EXIM ToolKit is so comprehensive, 
we’re convinced it’s the only BASIC Software 
Library you’ll ever need. 

he PS: $ 45 


2 EXIM > ° 


EXIM SERVICES OF N.A. INC. 
P.O. Box 5417 
Clinton, New Jersey 08809 
(201) 735-7640 
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Since 1981 HALO 
has been the 

industry standard 
library of graphic 
subroutines for the PC. 
HALO has the largest inst- 
alled base of end-users and 
more ISV’'s than any graphics 
software environment. 

































Why? Because HALO grows with the 
industry. Graphics experts at Media 
Cybernetics are constantly improving 
HALO and expanding its compatibility. 
HALO supports 16 programming 
languages and over 125 devices. 
HALO is also compatible with IBM's 
new hardware series. 


Media Cybernetics offers HALO 
programmers professional support, 
flexible, practical licensing terms, and 
the continuing commitment to assure 
that HALO will always be the most 
effective graphic toolkit in the industry. 







































List: $300 PS: $209 
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Call Today for FREE detailed information or try Risk-Free for 31 days, any product on this page. 


HOURS: 8:30 A.M.-8:00 P.M. E.S.T. cnisarngets . near Gs ° 
$-)Pond Park Road, Hingham, MA 02043 S00- 491-8006 rHE PROGRAMMER’S SHOI 


Mass: 800-442-8070 or 617-740-2510 Your complete source for software. services and answers 















Listing Two (Listing continued, text begins on page 30.) 


3: ind3:=i; 
END; 
IF selector <> i THEN {item not selected} 
attrib:=Low 
ELSE 
BEGIN 
attrib:=Rev; 
tindl:=indl; 
tind2:=ind2; 
tind3:=ind3; 


END; 
WriteString(atree[indl,ind2,ind3].title, 
attrib); 
write(’ ‘); {spaces to separate items} 
END; 
GoToxY (9,MenuLine4) ; 
clreol; 


write(atree[tindl,tind2,tind3].desc); 


END; 


PROCEDURE ProcessCr (VAR indl,ind2,ind3,level, 
selector,cmd_code:Byte) ; 


BEGIN 
{assign selector to index as it was picked} 
CASE level OF 
1: indl:=selector; 
2: ind2:=selector; 
3: ind3:=selector; 
END; 
{if entry is terminal entry} 
IF atree[indl,ind2,ind3].index = 0 THEN 
BEGIN 
{get associated cmd code} 
cmd_code:=atree[ind1l, ind2, ind3] .ccode; 


{process depending upon level} 
CASE level OF 


1: indl:=0; 

2: BEGIN 
indl:=0; 
ind2:=0; 
ind3:=0; 
level:=1; 

END; 

3: BEGIN 
ind2:=0; 
ind3:=0; 
level:=2; 

END; 
END; 
END 
ELSE 
BEGIN 


{down to next menu level} 
level:=levelt+l; 
END; 
{select set to lst item} 
selector:=1l; 


END; 


PROCEDURE ProcessMenu (VAR indl,ind2,ind3,level, 
selector,cmd_code:Byte) ; 


VAR 
key: Char; 
position: Integer; 
BEGIN 


key :=upcase (GetKey) ; 
CASE key OF 
Yarrow: BEGIN 

selector:=selector+l; 

IF selector > 

length (atree[indl,ind2,ind3].chars) THEN 
selector:=1; 
END; 


larrow: BEGIN 
selector:=selector-1; 
IF selector < 1 THEN 
selector := 
length (atree[indl,ind2,ind3].chars); 
END; 


72 


endkey: selector := 
length (atree[indl,ind2,ind3] .chars) ; 


home: selector:=l1; 


cr: ProcessCr(indl,ind2,ind3,level, 
selector,cmd_code); 


esc: cmd_ code := 1; {force exit} 


7A’. .72",70"..79" {list letter of menu item ?} 
: BEGIN 
position := 
pos (key, atree[indl,ind2,ind3].chars) ; 
IF position <> 0 THEN 
BEGIN {is lst letter} 
selector:=position; 
ProcessCr (indl,ind2,ind3,level, 
selector,cmd_code) ; 
END 
ELSE {is not so beep} 
Beep; 
END; 
ELSE {invalid so beep} 
beep; 
END; 


END; 


{Procedure used to process the operator} 
{selected commands} 
{Defined in the main program’s code} 


PROCEDURE ProcessCmd (cmd_code: Byte); FORWARD; 


FUNCTION DoMenu : Boolean; 
VAR 

Line: Integer; 
BEGIN 


{stop update of screen info} 
UpdateScreenStatus := False; 


{clear top 6 display lines} 
FOR Line := 1 TO 6 DO 
BEGIN 

GoToxY (1, Line) ; 

Clreol; 
END; 


{and 2nd to the last one} 
GoToXY (1,24); 
Clreol; 


DrawMenuFrame; 
{clear the menu exit flag} 
ExitMenu := False; 


{clear the program exit flag} 
ExitProgram := False; 


{selector to lst item in menu} 
selector:=1l; 


{command code initialized to 0 } 
cmd_code:=0; 


{lst tier of heirachy} 
level:=1; 


{root menu array location} 
indl:=0; 
ind2:=0; 
ind3:=0; 


REPEAT 


DisplayMenu (indl,ind2,ind3,level,selector) ; 
ProcessMenu (indl,ind2,ind3,level,selector, 


cmd_code) ; 
ProcessCmd (cmd_code); 
cmd_code:=0; {reset code selected last} 


UNTIL ExitMenu; 


{start update of screen info} 
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UpdateScreenStatus := True; 
{return flag} 
DoMenu := ExitProgram; 


END; 


PROCEDURE Init_Menu; 
{initialize the menu tree} 
BEGIN 
fillchar (atree, sizeof (atree) ,0); 


WITH atree[0,0,0] DO 

BEGIN 
title:=’Main Menu’; 
chars:=’QPDTFCE’ ; 
index:=7; 

END; 


WITH atree[1,0,0] DO 

BEGIN 
title:=’Quit’; 
desc:=’Exit Analyzer Menus’; 
ccode:=l; 

END; 


WITH atree[2,0,0] DO 

BEGIN 
title:=’ Parameters’; 
desc:=’Set Serial Parameters’; 
chars:=’ QBSWP’ ; 
index:=5; 

END; 


WITH atree[2,1,0] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this submenu’; 
END; 


WITH atree[2,2,0] DO 
BEGIN 
title:=’Baud Rate’; 


desc:=’Change Serial Baud Rate’; 


chars:='Q361249/; 
index:=7; 
END: 


WITH atree[2,2,1] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this submenu’; 
END; 


WITH atree[2,2,2] DO 
BEGIN 
title:=’300’; 
ccode:=2; 
END; 


WITH atree[2,2,3] DO 
BEGIN 
title:='’600’; 
ccode:=3; 
END; 


WITH atree[2,2,4] DO 
BEGIN 
title:='1200’; 
ccode:=4; 
END; 


WITH atree[2,2,5] DO 
BEGIN 
title:='’2400’; 
ccode:=5; 
END; 


WITH atree[2,2,6] DO 
BEGIN 
title:='’4800’; 
ccode:=6; 
END; 


WITH atree[2,2,7] DO 
BEGIN 
title:=’9600’; 
ccode:=7; 
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END; 


WITH atree[2,3,0] DO 
BEGIN 
title:=’Stop Bits’; 
desc:=’Set Number of Stop Bits’; 
chars:='Q12’; 
index:=3; 
END; 


WITH atree[(2,3,1] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this submenu’; 
END; 


WITH atree[2,3,2] DO 
BEGIN 
title:='1/; 
ccode:=8; 
END; 


WITH atree[2,3,3] DO 
BEGIN 
title:='2’; 
ccode:=9; 
END; 


WITH atree[2,4,0] DO 

BEGIN 
title:=’Word Len.’; 
desc:=’Set Bits / Word’; 
chars:='Q5678’; 
index:=5; 

END; 


WITH atree[2,4,1] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this SubMenuv’; 
END; 


WITH atree[2,4,2] DO 
BEGIN 
title:=’5'; 
ccode:=10; 
END; 


WITH atree[2,4,3] DO 
BEGIN 
title:=’6/'; 
ccode:=11; 
END; 


WITH atree[2,4,4] DO 
BEGIN 
title:='7/; 
ccode:=12; 
END; 


WITH atree[2,4,5] DO 
BEGIN 
title:='8'; 
ccode:=13; 
END; 


WITH atree[2,5,0] DO 

BEGIN 
title:=’Parity’; 
desc:=’Set Serial Parity’; 
chars:=’ QOEN’; 
index:=4; 

END; 


WITH atree[2,5,1] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this SubMenu’ ; 
END; 


WITH atree[2,5,2] DO 
BEGIN 
title:='0Odd’ ; 
ccode:=14; 
END; 


WITH atree[2,5,3] DO 
BEGIN 
title:=’Even’; 
ccode:=15; 
END; 


(continued on page 75) 





NROFF/PC™ 


The REAL Thing for DOS 


NROFF/PC is a complete 
text formatting system for 
MS-DOS systems. Including: 


NROFF The powerful UNIX 
text formatter 


TBL A tool to assist 
with the layout of 
tabular material in 
Nroff documents 


A comprehensive 
Nroff macro pack- 
age for preparing 
books and _ tech- 
nical manuals 


A tool for describ- 
ing mathematical 
equations in Nroff 


documents 


eAll tools are a complete port 
from the AT&T Documentor’s 
Workbench 2.0 


elt’s Fast! We've modified 
Nroff especially for DOS for 
lightning speed 


e Supports any Dot Matrix printer 
and many laser printers 


e Specially Priced At $99 


eA complete Troff typesetting 
system is available NOW for 
LaserJet and PostScript printers 
on MS-DOS for $695, XENIX 
and Microport UNIX for $795. 


Elan Computer Group, Inc. 
410 Cambridge Ave., Suite A 
Palo Alto, CA 94306 
(415) 322-2450 


Visa and MasterCard Accepted 


Unixis a tradmark of AT&T 
MS-DOS and Xenix are tradmarks of Microsoft 
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THE 13m WEST COAST 


(COMP ULI) RATIRIE 


April 7-10, 1988 ¢ Moscone Center ¢ San Francisco, CA 


I, 1988 the capitals of the computer coasts will 
be the sites of the most comprehensive events for more 
new business: The 13th West Coast Computer Faire and 
the 11th Northeast Computer Faire. 


Bese 82TH S228 2 ess cls 
San Francisco and Boston are the hubs of regions ripe See a on 
with people who know computers. Enthusiasts who have SS Sivee 2: Sao SF Sisl =. 


mastered the old and hunt for the new. Business people 
who know what to use and what to buy. People who will 
be coming to the shows to put their money where their 
knowledge is. And they’ll be coming en masse; last year’s 
West Coast Computer Faire drew in 43,500 attendees. 


I want to coast into more business! | 
C) Send me complete 1) West Coast 0 Northeast Computer Faire exhibitor 
information, including brochure, floorplan, and contracts. 


C) Send me attendee information. 


[ 
And we help you get the edge on bigger business than | 
ever with highly-visible promotion, a highly-praised | 

| 


C) Have a Sales Representative call me today. 


Name 


conference series, and highlights like State-of-the-Art 
Professional Development Seminars. 

Company 
Coast into Computer Faire business by reserving your 
exhibit space today. Call (617) 449-6600, ext. 4014. 


Address 





City State Zip 


Telephone ( ) 





Return to: Marketing Department 
Computer Faire 
300 First Avenue, Needham, MA 02194. 


Title - as | 
OE a ee Pa Be CR ee OR PPL) ee 
| 
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Listing Two (Listing continued, text begins on page 30.) 


WITH atree[2,5,4] DO 
BEGIN 
title:=’None’ ; 
ccode:=16; 
END; 


WITH atree[3,0,0] DO 
BEGIN 
title:=’Display’; 
desc:=’Select Channels for Display’; 
chars:='’Q12B’; 
index:=4; 
END; 


WITH atree[3,1,0] DO 
BEGIN 

title:=’Quit’; 

desc:="’Exit this SubMenu’; 
END; 


WITH atree[3,2,0] DO 
BEGIN 
title:=’ COMI’; 
ccode:=17; 
END; 


WITH atree[3,3,0] DO 
BEGIN 
title:=’COM2’; 
ccode:=18; 
END; 


WITH atree[3,4,0] DO 
BEGIN 
title:=’Both 1 & 2’; 
ccode:=19; 
END; 


WITH atree[4,0,0] DO 

BEGIN 
title:=’Trigger’ ; 
desc:=’Controls Trigger Modes’ ; 
chars:=’QCPMS’ ; 
index:=5; 

END; 


WITH atzee[4,1,0] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this SubMenv’ ; 
END; 


WITH atree[4,2,0] DO 
BEGIN 
title:=’Channel’; 
desc:=’Set Trigger Channel’; 
chars:='’Q127, 
index:=3; 
END; 


WITH atree[4,2,1] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this SubMenv’ ; 
END; 


WITH atree[4,2,2] DO 
BEGIN 
title:=’COM1’; 
ccode:=20; 
END; 


WITH atree[4,2,3] DO 
BEGIN 
title:=’COM2’; 
ccode:=21; 
END; 


WITH atree[4,3,0] DO 

BEGIN 
title:=’Pattern’; 
desc:=’Input Pattern for Trigger’; 
ccode:=22; 

END; 


WITH atree[4,4,0] DO 

BEGIN 
title:=’ Mode’ ; 
desc:=’Select Trigger Mode’; 
chars:=’ QBAE’ ; 
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index:=4; 
END; 


WITH atree[4,4,1] DO 
BEGIN 

title:="’Quit’; 

desc:=’Exit this SubMenu’; 
END; 


WITH atree[4,4,2] DO 

BEGIN 
title:=’ Before’ ; 
desc:=’Display Data Before Trigger’; 
ccode:=23; 

END; 


WITH atree[4,4,3] DO 

BEGIN 
title:=’After’; 
desc:=’Display Data After Trigger’; 
ccode:=24; 

END; 


WITH atree[4,4,4] DO 

BEGIN 
title:=’Enable’ ; 
desc:=’Enable the Trigger’; 
ccode:=25; 

END; 


WITH atree[4,5,0] DO 
BEGIN 
title:=’ Stop’; 


desc:=’Stop waiting for Trigger Event’; 


ccode:=26; 
END; 


WITH atree[5,0,0] DO 
BEGIN 
title:=’ Format’; 
desc:=’Set Display Format’; 
chars:=’ QAHS’ ; 
index:=4; 
END; 


WITH atree[5,1,0] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this SubMenv’ ; 
END; 


WITH atree[5,2,0] DO 
BEGIN 
title:="Ascili’; 
desc:=’Ascii Display Format’; 
chars:=’QNH’; 
index:=3; 
END; 


WITH atree[5,2,1] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this SubMenv’ ; 
END; 


WITH atree[5,2,2] DO 

BEGIN 
title:=’ Normal’; 
desc:=’Data Orly’; 
ccode:=27; 

END; 


WITH atree[5,2,3] DO 

BEGIN 
title:=’ HandShake* ; 
desc:=’Data and HandShake’ ; 
ccode:=28; 

END; 


WITH atree[5,3,0] DO 
BEGIN 
title:=’ Hex’ ; 
desc:=’Hex Display Format’; 
chars:=’ QNH’ ; 
index:=3; 
END; 


WITH atree[5,3,1] DO 
BEGIN 
title:=’Quit’; 
desc:=’Exit this SubMenu’; 


rm Editor Features 

Full control over foreground & background 
video attributes. 

Access to the extended (graphics) char. set. 
Line and box drawing. 

Define and modify field attributes: 

«= FieldName ® FieldOrder * Edit Mask 


* Default * Auto Tab Must Respond 

« Numeric Test = Right Justify = Echo Data 

* Display Only * Upper Case Warning Only 

* TestRange = Data Type Numeric Precision 
Test form utility. 

Generate program shell utility. 

Field reorder utility. 

Temporary exit to DOS. 

Compile form definitions to .OBJ files. 





n Time Library 


Routines are color (CGA, EGA, VGA) / 
monochrome independent. 

Forms are processed in dynamic memory. 
User written validation routines can be 
linked to fields. 

String, Byte, Integer, Long, Real, and Double 
data types are supported. 

Scrolling fields. 

Run time library source code included. 


Run time library includes (plus others): 

= load_form( ) =put_fieia() =get_form() 
erelease_form() =put_form() »*clear_form_buffer() 
*display_form() =get_field() =©alter_field_attrib () 


@ No royalties. 


bystem Requirements 


e IBM PC/XT/AT/PS2 or compatible. 
e PC-DOS or MS-DOS 2.0 or later 


‘Ordering Information 
MC/VISA/Checks. << DPpjices —=— 


Demodiskavailable. Turbo Pascal..... $99.95 
Call for shipping Microsoft Pascal ee 


ca2cs $149.95 
dates on other ver- Lattice C....... 
sions. 
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Listing Two (Listing continued, text begins on page 30.) 


END 


WITH atree[5,3,2] DO 

BEGIN 
title:=’Normal’ ; 
desc:=’Data Only’; 
ccode:=29; 

END; 


WITH atree[5,3,3] DO 

BEGIN 
title:=’HandShake’ ; 
desc:=’Data and HandShake’ ; 
ccode:=30; 

END; 


WITH atree[5,4,0] DO 

BEGIN 
title:=’Spaces’; 
desc:=’Insert space in data display’; 
ccode:=31; 

END; 


WITH atree[6,0,0] DO 
BEGIN 
title:=’Control’; 
desc:=’Alter Analyzer Operation’; 
chars:=’ QASCR’; 
index:=5; 
END; 


WITH atree[6,1,0] DO 
BEGIN 

title:=’Quit’; 

desc:=’Exit this SubMenuv’; 
END; 


WITH atree[6,2,0] DO 

BEGIN 
title:=’Acquire’ ; 
desc:=’Accuire Data’; 
ccode:=32; 

ENC; 





introducing... 


WITH atree[6,3,0] DO 

BEGIN 
title:=’Stop’; 
desc:=’Stop Data Acquisition’; 
ccode:=33; 

END; 


WITH atree[6,4,0] DO 

BEGIN 
title:=’Clear'; 
desc:=’Clear Screen of Data’; 
ccode:=34; 

END; 

WITH atree[6,5,0] DO 

BEGIN 
title:=’Reset’; 
desc:=’Peset Analyzer’; 
ccode:=35; 

END; 


WITH atree[7,C,0j DO 

BEGIN 
title:="’End’ ; 
desc:=’End the Analyzer Session’ ; 
ccode:=36; 

END; 


END: End Listing Two 
& @ 

Listing Three 
{ FRRRKEKKKKKKEKKKKKKKKKKEKEKKKEKKKEKKEEKEKKEKKKKKKKKKKKKK) 
{*** kkk} 
{*** RS-232 support procedures eek} 
{*** for the serial protocol analyzer xak} 
{ee written by ina 
{*** Craig A. Lindley wee} 
{*** eek} 
{*** Ver: 2.0 Last update: 08/15/87 kee) 
{*** kkk) 


{ EXRKKKKKKKKEKKEKKKKEKKKKEKEKKEKEKEKREKKEKKEKKKKKEKKEKKKEEKKKE } 


CONST 


COM1 = $3f8; 
COM2 = $2f8; 


{com one port addr} 
{com two port addr} 


eve 1 
Cito $239 


The future of programming is here! 


Cuts development time in half 


Revolutionary 


Load & execute C-procedures individually Fast 


Macro definitions enable interactive debugging 
Quick-language technology for UNIX /XENIX 


Powerful 


Reliable 


se Fillmore Systems, Inc. 
7200 York Ave. So. Suite 301 


Edina, Minnesota 55435 


gS 
(612) 831-6984 


UNIX is a trademark of AT&T. Xenix is a trademark of Microsoft Corp. 
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{table of values for the various baud rates} 
{supported by the 8250. Rates from 50..9600} 


BaudRate: ARRAY[1..15] OF Integer = 
($900, $600, $417, $359, $300, $180, $0C0, $060, 
$040, $03A, $030, $020,$018,$010,$00C); 


{8259 registers} 


Int_Mask Reg = $21; {interrupt enable register} 
Int_Cmd_ Reg = $20; {command register} 
End_Int_Cmd = $20; {end of interrupt cmd} 


{offsets from PortAddr for the various} 
{8250 registers} 


DLL 

DLM 
Int_Enable Reg 
Int_Id_ Reg 
LineControl 
ModemControl 
LineStatus 
ModemStatus 


Aun WNe FO 
i ee! ee ee! el el ee) 


{Status bit definitions} 


DataRdyBit 
DTRBit 
Out 2Bit 
ORBit 
RTSBit 
PEBit 
FEBit 
BrkBit 
CTSBit 
DSRBit 
TxRdyBit 
RIBit 
CDBit 


$01; 
$01; 
$08; 
$01; 
$02; 
$02; 
$04; 
$08; 
$10; 
$20; 
$20; 
$40; 
$80; 


TYPE 
ParityType = (odd,even,none) ; 


VAR 





Announcing 
WKS LIBRARY 


The Lotus **Wrap-Around’’ for C Programs 


Now you can write and read Lotus worksheets 
, directly from a C program! 
WKS LIBRARY lets you: 


© avoid time-consuming file translation steps 
© control the execution of 1-2-3 from inside your application 
© use Lotus as a data entry screen in your C program 
© generate ‘‘live’’ financial statements with formulas for totals 
Feature this: 
© reads and writes .WKS, .WK1 and .WRI1 worksheets 
© writes integers, floats, strings, formulas, macros and dates 
using wprint{Q 
reads using wscanf(), converting column contents to C 
variables according to format specs 
e has low-level functions for manipulating individual cells 
provides Lotus control functions such as: 
formats, column widths, initial cursor position, range 
names, cell protection 
supports Lattice, Microsoft & Turbo compilers for DOS, plus 
most UNIX environments 
Source Code provided No Royalties on executable programs 


Only $89 2 ORDER TODAY! 


(includes free fue) Toll-free 
800-line support) (800) 367-9882 


Tenon Software, Inc. 


po 1980 - 112th NE, #250, Bellevue, WA 98004 
(206) 453-1914 (in Washington state) 
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{Global storage of COM parameters} 
{Used by the SetNewCOMParameter} 
{procedure} 


COM Rate, 

COM _StopBits, 

COM DataBits: Integer; 
COM Parity: ParityType; 


{XXKKKKKKKEKEEE Serial Procedures REKKKKKKKKKKKEK) 
PROCEDURE Enable Serial Device (PortAddr: Integer) ; 
VAR 

Temp: Byte; 
BEGIN 


{clear the 8250 serial device of any garbage} 
{by reading data port, int id reg. line} 
{status reg and modem status reg} 


Temp := port [PortAddr]; 
Temp := port ([PortAddr+Int Id Reg]; 


Temp := port [PortAddr+LineStatus] ; 
Temp := port [PortAddr+ModemStatus] ; 


{read 8259 int mask reg and set IRQ3 or IRQ4} 
{low to enable requested interrupts. } 
{write result back to 8259 when finished} 


Temp := port[Int Mask Reg]; 
IF PortAddr = COMl1 THEN 
Temp := Temp AND SEF 
ELSE 
Temp := Temp AND $F7; 
port[Int_ Mask Reg] := Temp; 


{Out2, DTR and RTS high for 8250} 
port [PortAddr+ModemControl] := 
Out2Bit + DTRBit + RTSBit; 


(continued on next page) 


Amazing 


Your Original AMIGA™Monthly Resource 
FEATURIN 


Complete Amiga Hardware and Software reviews 
*A vast and growing library of over 110 PDS Disks 
*Solid and informative for both the advanced 

and beginning Amiga User 
*Understandable program listings and tools 
*Step by Step Hardware projects 


Amiga Users have made Amazing Computing™ the longest mmning 
Monthly magazine dedicated to the Commodore Amiga If you are 
searching for Amiga technical information that is both current and 
comprehensive, then be amazed by the pioneer Amiga Magazine, 
Amazing Computing - your Original AMIGA Monthly Resource. 
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__ PROTOCOL ANALYZER 


Listing Three (Listing continued, text begin on page 30.) 







{all ints active except Tx} BEGIN 
port [PortAddrt+Int_ Enable Reg] := $0D; 
delay (100); {read linestatus and modem status and} 
{combine into COMl Status. See text for} 
END; {bit encoding. } 











LineState := port [COMl+LineStatus] ; 
PROCEDURE Disable Serial Devices; ModemState:= port [COM1+ModemStatus] ; 
Temp := (LineState SHR 1) AND SOF; 






VAR 











{COM1 Status has the UART state in 8 bits} 
Temp: Byte; {this is comprised of status info only, no data} 











BEGIN COM1 Status := (ModemState AND $F0) OR 1lo(Temp); 






{Read int mask in 8259, set both IRQ3} {if there is data to receive and we are} 












{and IRQ4 bits high to disable. Set Out2} {acquiring data} 
{low for both COMl1 and COM2 to prevent ints} 
{from leaving the async card and finally} IF (((LineState AND DataRdyBit) <> 0) AND 
{disable all interrupt sources in the UART} COMl1 Data Acquire) THEN 
BEGIN 
Temp := port[Int_Mask Reg]; {if there is room in the COM1 input fifo} 
Temp := Temp OR $18; IF COMl1 Input Fifo.Ovd.Count < 
port [Int Mask Reg] := Temp; . "SerialDataFifoSize THEN 
port [COM1+ModemControl] := 0; BEGIN 
port [COM2+ModemControl] := 0; {Put received data and status into fifo} 










port [COMl+Int_ Enable Reg] := 0; SerialiInfo.Data := port [COM1]; 
port [COM2+Int_ Enable Reg] := 0; SerialInfo.Status := COM] Status; 
PutSerialData(SerialInfo,COMl Input Fifo); 
END; = a 
END 
ELSE 
BEGIN 
PROCEDURE COM1_ISR; writeln(’COMl1 Input fifo overflowed’); 
: . . halt; 
{COM1 interrupt service routine} END: 






END; 





VAR 







{signal end of int to 8259} 


SSELSLERES: PerEnece port [Int _Cmd_ Reg] := End_Int_Cmd; 












Temp: 





Integer; END: 





LineState, 
ModemState: Byte; 









PROGRAMMERS! 
THE TooLs You NEED 
AT A PRICE YOU’LL LIKE 


Supports all index file operations. Very quick 
sequential or random access, duplicate keys, multiple 75.00 NOW 
indices, fixed and variable length data records are all supported. M ULTI 

Works on top of BTree to provide a simple, yet -USER 
powerful application program/file system interface. 40.00 AVAILABLE 
Complex filesystem manipulation becomes a snap. Provides the power 


of a database manager with the flexibility of a programming language. 60.00 


Finally, a completely device independent printer library! 
Ip drives any printer as accurately as possible and allows easy access to 75.00 
its most sophisticated features. Multiple fonts, multi-column output, complex margin 
formatting, and much more. Pays for itself the first time it’s used. 


The ultimate ‘make’ utility. We couldn’t find a good one, so 
we wrote a great one. Has all kinds of powerful features including wild 59.00 
card filename expansion, nested macros, and multiple dependency and rules defini- 
tions. Ready to go for MS-DOS; C source is there if you use another operating 
system. 


Combine & Save: Biree + ISAM + Ip 159.00+ snake 199.00 


Each product includes a typeset manual, example programs, and complete C source 1343 Stanbury Drive 
code that runs on any operating system. Softfocus products may be incorporated into OF-1 a7 | [Fa ©] a) €- tale mm @r-lal-(ol-| 
applications royalty-free. L6L 2J5 


Credit card orders accepted. Visa, M/C, Amex. Dealer inquiries invited. (416) 825-0903 
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PROCEDURE COM2_ ISR; 


{COM2 interrupt service routine} 
VAR 

SerialInfo: DataRec; 

Temp: Integer; 


LineState, 
ModemState: Byte; 


BEGIN 


{read linestatus and modem status and} 
{combine into COM2 Status. See text for} 
{bit encoding. } 


LineState := port [{COM2+LineStatus] ; 
ModemState:= port [COM2+ModemStatus]; 
Temp := (LineState SHR 1) AND SOF; 


{COM2 Status has the UART state in 8 bits} 
{this is comprised of status info only, no data} 


COM2_ Status := (ModemState AND $F0) OR lo(Temp); 


{if there is data to receive and we are} 
{acquiring data} 


IF (((LineState AND DataRdyBit) <> 0) AND 
COM2_ Data Acquire) THEN 
BEGIN 
{if there is room in the COM2 input fifo} 
IF COM2 Input_Fifo.Ovd.Count < 
SerialDataFifoSize THEN 
BEGIN 
{Put received data and status into fifo} 
SerialInfo.Data := port [COM2]; 
SerialInfo.Status := COM2 Status; 
PutSerialLata(SerialInfo,COM2 Input _Fifo); 
END 
ELSE 
BEGIN 
writeln(’COM2 Input fifo overflowed’); 
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halt; 
END; 
END; 


{signal end of int to 8259} 
port[Int_Cmd_Reg] := End_Int_Cmd; 


END; 


PROCEDURE COM1_ Int _Service_Routine; 
BEGIN 


INLINE ($50/$53/$51/$52/$57/ {Push ax, bx,cx, dx, } 


$56/$06/Sle/ {di,si,es,ds} 
$2e/$al/turbodseg/ {mov ax,cs:turbodseg} . 
$8e/$d8/ {mov ds,ax} 
$fb); {sti} 

COM1_ISR; 


{standard interrupt service routine postamble} 


INLINE ($fa/$1£/$07/$S5e/$5f/ {interrupts off} 


$5a/$59/$5b/$58/ {Pop ds,es,si,di, } 
{dx,cx, bx,ax} 
$5da/$5d/$cf); {trash sp, restore} 


{Bp and iret} 
END; 
PROCEDURE COM2 Int Service Routine; 
BEGIN 


INLINE ($50/$53/$51/$52/$57/ {Push ax,bx,cx, Gx, } 


$56/$06/$le/ {di,si,es,ds} 
$2e/$al/turbodseg/ {mov ax,cs:turbodseg} 
$8e/$d8/ {mov ds,ax} 
$fb); {sti} 

COM2_ISR; 


{standard interrupt service routine postamble} 


(continued on next page) 
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Listing Three (Listing continued, text begins on page 30.) 


INLINE ($fa/$1f£/$07/$5e/$5£/ {interrupts off} {move databits into 2 least sign bits} 
$5a/$59/$5b/$58/ {Pop ds,es,si,di, } {add in stop bit into bit pos 2} 
{dx, cx, bx, ax} {set parity enable and parity even} 
$5d/$5d/S$cf); {trash sp, restore} {bits if appropriate} 


{Bp and iret} 
Temp := (DataBits - 5) AND $03; 
Temp := Temp OR ((StopBits - 1) SHL 2); 
CASE Parity OF 
odd: Temp := Temp + $08; 
even: Temp := Temp + $18; 


END; 


PROCEDURE Install Serial Handlers; 


none: ; 
END; 
BEGIN 
{remove DLAB and setup parameters} 
WITH regs DO {install into IRQ3 «& 4} port [PortAddr+LineControl] := lo(Temp); 
BEGIN delay(100); 
ah := $35; {get vector func. code} 
al := SOB; {for IRQ3} END; 
msdos (regs) ; {call dos to get vector} 
OldIRQ3_CS := es;{save code seg} 
OldIRQ3_IP := bx; {and instruction ptr} FUNCTION Get_Serial Status (PortAddr: Integer) 
:Integer; 
ah := $35; {get vector func. code} 
al := $0C; {for IRQ4} VAR 
msdos (regs) ; {call dos to get vector} 
OldIRQ4 CS := es;{save code seg} Temp: Integer; 
OldIRQ4 IP := bx;{and instruction ptr} 
BEGIN 
ah := $25; {set vector func. code} 
al := $0C; {for IRQ4} {Get full 16 bits of COM port status} 
ds := cseg; {code in our segment} {grouped as ModemStatus:LineStatus} 
{at this offset} 
¢x := ofs(COMl_ Int_Service Routine) ; Temp := port [PortAddr+ModemStatus] ; 
msdos (regs) ; {call dos to set vector} Temp := Temp SHL 8; 
Temp := Temp OR port [PortAddr+LineStatus]; 
ah := $25; {set vector func. code} Get_Serial Status := Temp; 
al := SOB; {for IRQ3} # ig 
ds := cseg; {code in our segment} END; 
{at this offset} 
dx := ofs(COM2_ Int_Service Routine) ; 
msdos (regs) ; {call dos to set vector} PROCEDURE SetNewCOMParameter; 
END; BEGIN 


END; 


{take the COM ports down} 


Disable Serial Devices; 
PROCEDURE Remove Serial Handlers; 


{Set the COM ports to the global parameters} 
BEGIN 


{Put saved vectors for IRQ3 and IRQ4 back} Set_Serial_ Parameters (COM1,COM Rate, 
WITH regs DO COM_StopBits,COM DataBits,COM Parity); 


BEGIN Set_Serial_Parameters(COM2,COM Rate, 
ah := $25; COM_StopBits,COM DataBits,COM Parity); 
al := $0c; 
ds := Ol1dIRQ4 Cs; {bring COM ports back up} 
dx := OldIRQ4 IP; Enable Serial Device(COM1); 
msdos (regs) ; Enable Serial Device (COM2) ; 
ah := $25; END; 
al := SOB; 
ds := OldIRQ3 Cs; 


dx := OldIRQ3_IP; 
msdos (regs); 
END; 


END; 
PROCEDURE Set_Serial Parameters End Listing Three 


(PortAddr, Baud, StopBits, DataBits: Integer; 
Parity: ParityType); 


VAR 
e a 
Listing Four 
Temp, 
Rate: Integer; 
{$K-} {Compiler switch - never change} 
BEGIN 
{ESASERRAERRRRERARRERERREREREEEREREREREREKKRERERE ) 
{set DLAB high for divisor regs} dad aaK) 
port [PortAddr+LineControl] := $80; {es Turbo Pascal aa*) 
{*** Multitasking Kernel wee) 
{look up rate word in table} tye* written by ake) 
Rate := BaudRate([Baud]; ¢=*s Craig A. Lindley aae) 
{[*** ke} 
{MSB into most sign divisor reg} dies Ver: 2.0 Last update: 08/15/87 ea 
port [PortAddr+DLM] := hi(Rate); {eee ake) 


{BASRA ARRERERARRAKERERR EKER ERR RERR EKER EERE EER ERE) 
{LSB into less sign divisor reg} 
port [PortAddr+DLL] := lo(Rate); CONST 


task_stack_size = 1000; 
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PROCEDURE Yield; 
e INLINE ($C6/$06/child_process/$00/ 
{This version in assembly language for} isto cera eee 
{speed. See version above for comments. } asia pe A 
a $05/$02/$00/ {add ax,2} 
$26/ {es:} 
das 89/$45/$04 i 
IF cp*.link <> cp THEN {must have more than} th fies a age 
{one task forked to be} $C6/$45/$06/$01/ {mov byte ptr [dité],1} 
pee {able to yield} $89/$FB/ {Ll: mov bx,di} 
$26/ : 
INLINE ($C6/$06/child_process/$00/ $c4/$1F/ Las Oe eel 
{child process is false} $26/ {es:} 
$C4/$3E/cp/ {les di, [cp] } $80/$7F/$06/$00/ {cmp byte ptr [bx+6],0} 
$89/SE0/ {mov ax,sp} $74/$04/ {je L2} 
$05/$02/$00/ {add ax,2} $89/SDF/ {mov di, bx} 
$26/ {es:} SEB/SFO/ {jmp Ll} 
$89/$45/$04/ {mov [di+4],ax} $89/$1E/cp/ {L2: mov [cp],bx} 
$26/ {es:} $8C/$06/cpt2/ { mov [cpt+2],es} 
$C6/$45/$06/$00/ {mov byte ptr [di+6],0} $26/ {es:} 
oe orb od bx, di} $C6/$47/$06/$02/ {mov byte ptr [bx+6],2} 
es: $26/ {es:} 
$c4/$1F/ {les bx, [bx] } $8B/S6F/$04); {mov bp, [bx+4] } 
$26/ {es:} 
$80/$7F/$06/$00/ {cmp byte ptr [bx+6],0} END 
$74/$04/ {je L2} ELSE 
$89/$DF/ {mov di, bx} BEGIN 
SEB/SFO/ {jmp Ll} writeln(’Cannot wait 1 ingle task ing’); 
$89/$1E/cp/ {L2: mov [cp],bx} halt; rE a ee eee 
$8C/$06/cp+2/ { mov [cpt+2],es} END; 
$26/ {es:} 
$C6/$47/$06/$02/ {mov byte ptr [bx+6],2} END; 
$26/ {es:} 
$8B/$6F/$04); {mov bp, [bx+4] } End Listings 
END 
ELSE 
BEGIN 
writeln(’Cannot yield only single task running’); 
halt; 
END; 
END; 
PROCEDURE Wait; {put current task in wait mode} 
{until a send makes it ready} 
BEGIN 
IF cp*.link <> cp THEN {must have more than} 
{one task forked to be} 
{able to wait} 
BEGIN 
waitfor* := cp; {waitfor points at the} 
{current task} 
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multiple simultaneous changes and undo intermediate 
revisions. Network and WORM optical disk support. 

e Includes a copy of Landon Dyer'’s excellent public domain 
MAKE utility (with source code for DOS & VAX/VMS). 


MS-DOS 2.x &3.x Just $99.95 + $3 s/h Visa/MC 
BURTON SYSTEMS SOFTWARE 

P.O. Box 4156, Cary, NC 27519 

(919) 469-3068 


disassemblers 


compilers 


Cr+ se WAVININS 


text editors 

text filters 
communications support 
text formatters 


interpreters U sers CG, rou p 
bulletin boards Library 


co-routines 


We specialize in 
C++ Training, Development 
and Support 


compiler compilers 


window packages 


Scheduled and on-site courses. available 


C= 
=, 


SEMAPHORE, INC. 


A subsidiary of Glockenspie} of Dublin 


A Directory 


assemblers of Public Domain 
games C Source Code 


| tutorials 
math packages 
link editors 
Flare l¥r- le) 
cross compilers 
pre-processors 
function libraries 
disassemblers 


compilers 


16 Haverhill Street 
Andover, MA 01810 


(617) 474-0040 


text editors 





CERTIFICATION 
SEAL 





CIRCLE NO. 152 ON READER SERVICE CARD 
CIRCLE NO. 151 ON READER SERVICE CARD 


Dr. Dobb’s Journal, February 1988 81 





Listing One (Text begins on page 92.) 
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Listing ft -- fdump.c, Printed 10/29/1987 


#include <fcentl.h> 
#include <ctype.h> 


/* Binary file dump utility. Usage is: 

* fdump file... Dump all files listed on command line 
* fdump +N file Start N bytes from start of file 

* fdump -N file Start N bytes from end of file. 


printf("%061x: ", 
Bytenum += nbytes; 


Bytenum ); 


#include <stdio.h> 


lt 
extern long lseek( int, long, int ); 
/* eS eS ee i a ae a ea a gee relearn ths Samia esha a med mes ems x / 
#define BUFSIZE 16 
#define CR 0x0d 
#define LF 0x0a 
#define C_CR 0x11 /* Print left arrow for CR ‘a 
#define C_LF 0x19 /* Print down arrow for LF af 
#define isprinting(c) (’ ’ <= (c) &&°  (e) <= *") 
static long Bytenum = OL; 
[ BSS ee ee Seno ardiyeca elem s bi a */ 
mMain(argc, argv) 
int argc; 
char **kargv; 
{ 
register int fd; 
long offset = OL; 
if( arg¢ == 1.) 
usage (); 
++argv; 
--argc; 
if( **argv == '-' || *kargy == ‘+! ) 
{ 
if( !isdigit( argv[0][1] ) ) 
usage (); 
offset = atoi( argv[0] ); 
++argv; 
--argc; 
} 
for (; ~~arge >= 0 ; ++argv ) 
{ 
if( (fd = open( *argv, O_RDONLY | O _BINARY)) == -1 ) 
perror( *argv ); 
else 
{ 
if( offset > 0 ) 
Bytenum = lseek( fd, offset, SEEK SET ); 
else if( offset < 0 ) 
Bytenum = lseek( fd, offset, SEEK _END ); 
dofile( fd ); 
close ( fd ); 
} 
} 
exit (0); 
} 
fe mi mat tats oto ge aes be re ahr a gas sa parang ess o ew ences a egg */ 
usage () 
{ 
fprintf(stderr, "Usage fdump [+|- N] file...\n"); 
fprintf(stderr, "+N Start dump at byte N\n"); 
fprintf(stderr, "-N Start dump N bytes from EOF\n"); 
exit ( 1°)3 
} 
/* Tn TL RE ge ee ea om a ee al ea es Na a sant main Peal ae me ala ace Wh ms LAS x / 
dofile( fd ) 
int fd; 
{ 
static char buf[{ BUFSIZE ]; 
register char nbytes; 
while( (nbytes = read(fd, buf, BUFSIZE)) > 0 ) 
doline( buf, nbytes ); 
} 
/* en Re contend a att 2 te Se en ie ee TR aeRO * / 
doline( buf, nbytes ) 
char ‘pnts 
{ 
static char hex[] = "0123456789abcdeft" 
register int ze 
register char *p; 
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108 | 
109| 
110] 
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112| 
113] 
114| 
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122 | 
123| 
124| 
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129) 
130] 
131] 
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134 | 
135) 
136| 


} 


ror({ J. = ‘i, 
{ 


Pp = buf ; i <= BUFSIZE ; i++ , p++ ) 


if( i <= nbytes ) 


putchar( hex[ 
putchar( hex[ *p 


(*p >> 4) © Oxf ) ys 
& Ost] >); 


putchar(, ” * ); 
putchar( ’ ’ ); 


putchar( ’ ’ ); 
} 


putchar(’ ’); 


for( i= 1, p = buf ; i <= nbytes ; i++ , pt+ ) 


{ 
if( *p == CR ) 
Pputchar( C_CR ); 


else if( *p == LF ) 
putchar( C LF ); 
else * 
putchar( isprinting(*p) 2? *p : ’." ye 
} 


putchar(’\n’); 
putchar(’\r’); 


End Listing 
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Your 80386-based PC should run two to 
three times as fast as your old AT. This 
speed-up is primarily due to the doubl- 
ing of the clock speed from 8 to 16 MHz. 
The new MicroWay products discussed 
below take advantage of the real power 
of your 80386, which is actually 4 to 16 
times that of the old AT! These new pro- 
ducts take advantage of the 32 bit regis- 
ters and data bus of the 80386 and the 
Weitek 1167 numeric coprocessor chip 
set. They include a family of MicroWay 


mW1167 Numeric 
Coprocessor Board 





MicroWay 80386 Compilers 


NDP Fortran-386 and NDP C-386 are globally 
optimizing 80386 native code compilers that 
support a number of Numeric Data Processors, 
including the 80287, 80387 and mW1 167. They 
generate mainframe quality optimized code and 
are syntactically and operationally compatible to 
the Berkeley 4.2 Unix f77 and PCC compilers. 
MS-DOS specific extensions have been added 
where necessary to make it easy to port pro- 
grams written with Microsoft C or Fortran and 
R/M Fortran. 

The compilers are presently available in two 
formats: Microport Unix 5.3 or MS-DOS as ex- 
tended by the Phar Lap Tools. MicroWay will port 
them to other 80386 operating systems such as 
OS/2 as the need arises and as 80386 versions 
become available. 

The key to addressing more than 640 kbytes 
is the use of 32-bit integers to address arrays. 
NDP Fortran-386 generates 32-bit code which 
executes 3 to 8 times faster than the current 
generation of 16-bit compilers. There are three 
elements each of which contributes a factor of 2 
to this speed increase: very efficient use of 
80386 registers to store 32-bit entities, the use of 
inline 32-bit arithmetic instead of library calls, 
and a doubling in the effective utilization of the 
system data bus. 

Anexample of the benefit of excellent code isa 
32-bit matrix multiply. In this benchmark an NDP 
Fortran-386 program is run against the same 
program compiled with a 16-bit Fortran. Both 
programs were run on the same 80386 system. 
However, the 32-bit code ran 7.5 times faster 
than the 16-bit code, and 58.5 times faster than 
the 16-bit code executing on an IBM PC. 

NDP FORTRAN-386™ ............--- $595 
NDP C-386™..........2ce eee eeeeees $595 


Micro 
Way 





UNLEASH YOUR 80386! 


80386 compilers that run in protected 
mode and numeric coprocessor cards 
that utilize the Weitek technology. 

The benefits of our new technol- 
ogies include: 
e An increase in addressable memory 
from 640K to 4 gigabytes using MS- 
DOS or Unix. 
e A 12 fold increase in the speed of 32 bit 
integer arithmetic. 
e A 4 to 16 fold increase in floating point 





MicroWay Numerics 


The mW1167™ is a MicroWay designed high 
speed numeric coprocessor that works with the 
80386. It plugs into a 121 pin “Weitek” socket 
that is actually a super set of the 80387. This soc- 
ket is available on a number of motherboards 
and accelerators including the AT&T 6386, 
Tandy 4000, Compaq 386/20, Hewlett Packard 
RS/20 and MicroWay Number Smasher 386. It 
combines the 64-bit Weitek 1163/64 floating 
point multiplier/adder with a Weitek/Intel de- 
signed “glue chip”. The mW1167™ runs at 3.6 
MegaWhetstones (compiled with NDP Fortran- 
386) which is a factor of 16 faster than an AT and 


2 to 4 times faster than an 80387. 
mW1167 16 MHz...............:.: $1495 
mW1167 20 MHz..............022: $1995 


Monoputer™ - The INMOS T800-20 Trans- 
puter is a 32-bit computer on a chip that features 
a built-in floating point coprocessor. The T800 
can be used to build arbitrarily large parallel pro- 
cessing machines. The Monoputer comes with 
either the 20 MHz T800 or the T414 (a T800 
without the NDP) and includes 2 megabytes of 
processor memory. Transputer language sup- 
port from MicroWay includes Occam, C, Fortran, 
Pascal and Prolog. 

Monoputer T414-20 with 2 meg’ ...$1495 
Monoputer T800-20 with 2 meg’ ...$1995 


Quadputer™ can be purchased with 2, 3 or 4 
transputers each of which has 1 or 4 megabytes 
of memory. Quadputers can be cabled together 
to build arbitrarily fast parallel processing 
systems that are as fast or faster than today’s 
mainframes. A single T800 is as fast as an 
80386/mW 1167 combination! 

Biputer ™ T800/T414 with 2 meg' . . . .$3495 
Quadputer 4 T414-20 with 4 meg' . . .$6000 
‘Includes Occam 





speed over the 80387/80287 numeric 
coprocessors. 

Equally important, whichever Micro- 
Way product you choose, you can be 
assured of the same excellent pre- and 
post-sales support that has made Micro- 
Way the world leader in PC numerics 
and high performance PC upgrades. 
For more information, please call the 
Technical Support Department at 

617-746-7341 
After July 1988 call 508-746-7341 


MicroWay* 
80386 Support 


80386 Multi-User Solutions 


AT8™ - This intelligent serial controller series is 
designed to handle 4 to 16 users in a Xenix or 
Unix environment with as little as 3% degrada- 
tion in speed. It has been tested and approved by 
Compaa, Intel, NCR, Zenith, and the Department 
of Defense for use in high performance 80286 
and 80386 Xenix or Unix based multi-user 


systems. 

AT4 - 4.users....... oh pla iRPaniy Tah Dalat’ $795 
ATS: — 8 UGGS. cvcccccscceaedensewes’s $995 
AT16 - 16 users ...........0eeeeee: $1295 


Phar Lap™ created the first tools that make it 
possible to develop 80386 applications which 
run under MS-DOS yet take advantage of the full 
power of the 80386. These include an 80386 
monitor/loader that runs the 80386 in protected 
linear address mode, an assembler, linker and 
debugger. These tools are required for the MS- 
DOS version of the MicroWay NDP Compilers. 


Phar Lap Tools..............2s2e0005 $495 
PC/AT ACCELERATORS 

287Turbo-10 10 MHz................ $450 
287Turbo-12 12 MHz...............-. $550 
287TurboPius-12 12 MHz ........... $629 
FASTCACHE-286 9 MHz ............ $299 
FASTCACHE-286 12 MHz........... $399 
SUPERCACHE-286 .............00:: $499 
MATH COPROCESSORS 

80387-20 20 MHZ.........-.---0+-:- $895 
80387-16 16 MHz.........-....-+++:: $495 
80287-10 10 MHz............---+-+::- $349 
80287-8 8 MHZ .........-------20085 $259 
80287-6 6 MHZ .........--.----20005 $179 
SOBT+S BS RAZ . oc wwe cis eeciicewccncnes $154 
BOT 5 Ge 5 ox ec ewieawe ek ce sane ne $99 


The World Leader in PC Numerics 

P.O. Box 79, Kingston, Mass. 02364 USA (617) 746-7341 
32 High St, Kingston-Upon-Thames, U.K., 01-541-5466 
St. Leonards, NSW, Australia 02-439-8400 
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Listing One (Text begins on page 100.) 
Unit criterr; 


{ Critical error handler, Turbo Pascal Release 4.0 } 


Interface 
Uses dos, crt; 


{ EXTERNALLY VISIBLE PORTION } 


{ The following are for saving and restoring the screen, } 
{ which is assumed to be in text mode and display page 0 } 


Const bell = #7; 


Type scrnPtr = “scrnBuffer; 
scrnBuffer = array [1..4096] of byte; 


Var display, saveNode : scrnPtr; { display buffer } 
{ The following are global variables available to the using } 
{ program to find out if an error occurred and, if so, what } 
{ it was. The program can then take appropriate action. } 


criticalErrorOccurred : boolean: 


criticalErrorCode : integer; 
criticalErrorDrive : integer; 
criticalActionCode : char; 


{ The only externally visible routine installs the critical } 
{ error handler in Int 24h, replacing the DOS default. } 


Procedure InstallCEH; 
Implementation 


{ Following is a general-purpose critical error handler } 


{$F+} 
Procedure CEHandler { 

Flags, CS, IP, AX, BX, CX, DX, SI, DI, DS, ES, BP : word): 
Interrupt; 
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PRODUCTION QUALITY 


68020 
ANSI C Compiler 


Full 68020 instruction set 

Full 68881 support 

ANSI Standard reentrant library 
Extensive Sybolic Debug information 
Internal consistancy checking 
Position independant code 
ROMable code 



















PC Hosted cross-compiler 
single user license $ 995.00 


VME 68020 compiler 
single CPU lisence 


ANSI standard reentrant 
library source code $ 800.00 


SPECIAL OFFER 


For a limited time only we are offering full 
library source FREE with the purchase of either 
68020 C compiler 


817-599-8366 
P.O. Box 109, Weatherford, Texas 76086 






$ 1995.00 
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Var AH, AL : byte; 
row, col : integer; 
action : char; 


{ Local functions } 


{ giveReason lists reason for critical error by decoding the } 
{ low byte of the DI register. Called by procs DiskError and } 
{ CharDeviceError. Writes to screen. } 


Procedure GiveReason (error : byte); 
Begin 
Case error of 
$00: Writeln (’Write protect’); 
$01: Writeln (’Unknown unit’); 
$02: Writeln (’Drive not ready’); 
$03: Writeln (’Unknown command’); 
$04: Writeln (’CRC data error’); 
$05: Writeln (‘Bad request structure length’); 
$06: Writeln (’Seek error’); 
$07: Writeln (’Unknown media type’); 
$08: Writeln (’Sector not found’); 
$OA: Writeln (‘Write fault’); 
$0B: Writeln (’Read fault’); 
$0C: Writeln (’General failure’); 
$0D: Writeln (’Bad file allocation table’); 
else Writeln (’Unknown’); 
End; 
End; 


{ DiskError is dispatched when H/O bit of AH is 0 } 
Function DiskError : word; 
Var area, why : byte; 


Begin 
Writeln; 
CriticalErrorDrive := AL; 
Writeln (’Disk error on drive ’, char (AL + 65)); 
Area := (AH and 6) shr 1; { get AH bits 1-2 } 
Case area of 
0: Writeln (’Error in DOS communications area’); 
2: Writeln (‘Error in disk directory’); 
3: Writeln (’Error in files area’); 
End; 
Why := lo (DI); 
Write (’Type of error: ’); 
GiveReason (why) ; 
DiskError := why; 
End; 


{ error return code } 


{ NonDiskError is dispatched when H/O bit of AH is 1. } 
{ Usually triggered by a printer problem or bad FAT. } 


Function NonDiskError : word; 


Var why : byte; 
deviceAttr : “word; 
deviceName : “char; 
ch : shortInt; 

Begin 


DeviceAttr := ptr (BP, SI+4); { point to device attr word 
If (deviceAttr* and $8000) <> 0 then { if bit 15-42’ en.: :) 
Begin 
Writeln (‘Character device error’); 
Write (’Failing device is ’); 
ch := 0; 
Repeat 
deviceName := ptr (BP, SI + $0A + ch); 
Write (deviceName’%) ; 


—_ 


inc (ch); 
Until (deviceName* = chr (0)) or (ch > 7); 
Writeln; 
End 
Else { assume bad FAT } 
Begin 


Writeln (’Disk error has occurred’); 
Write (Probable cause: ’); 
Why := SOD; 
GiveReason (why); 
End; 
NonDiskError := why; 
End; 


{ return error code } 


Begin { Body of CEHandler procedure } 


CriticalErrorOccurred := TRUE; 
AH := hi (AX); 
AL := lo (AX); 
Col := wherex; 
Row := wherey; 
New (saveNode) ; 


{ set global flag } 


{ get current cursor position } 
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{ and save screen image 
{ beep to alert user 
{ if. AH bit 7 = 0 


SaveNode* := display; 
Write (bell); 
If (AH and $80) = 0 then 
CriticalErrorCode := DiskError 
Else 
CriticalErrorCode := NonDiskError; 
Repeat { what are we gonna do about the error? 
Write (’Abort/Retry/Ignore? ’); 
Action := upCase (readKey); 
Writeln (action); 
writil action im ("A's "I", °R'Is 
CriticalActionCode := action; 


If action = ’I’ then begin { pretend the error didn’t happen 


CriticalErrorOccurred := FALSE; 


CriticalErrorCode = 0; 

CriticalErrorDrive := SFF; 

CriticalActionCode = € ¢ 5 
End; 


Display* := saveNode“; 
Dispose (saveNode) ; 
Gotoxy (col, row); 

AX := 0; 


{ restore screen image 


{ tell DOS to ignore the error 


{ Externally visible: installs the error handler. 
{ NOTE: Program termination automatically reinstalls the 
{ default handler in the vector table. 


Procedure Install1CEH; 


Var videoMode : byte absolute $0040 : $0049; 

Begin 
SetIntVec ($24, @CEHandler); 
CriticaiErrorOccurred := FALSE; 
CriticalErrorCode = 0; 
CriticalErrorDrive := S$FF; 
CriticalActionCode nie Fs 
If videoMode = 7 then 

Display := ptr ($B000, $0000) 

Else 


Display := ptr ($B800, $0000); 


{ install in int 24h 
{ set globals 


{ set display address 


{ restore cursor position 





— 


—_ 


} 
} 


} 


End; 
End. 
End Listing One 
Listing Two 


Program cerrtest; 
{ Test critical error handler } 
Uses crt, dos, criterr; 


Var testFile : text; 
n, ignored : integer; 


Begin 
{$I-} 
ClrScr; 
Install1CEH; 
For n := 1 to 10 do 
Writeln (‘This is output line ’, n); 
Assign (testFile, ’A:TEST.FIL’); 


Repeat 
Rewrite (testFile); 
Ignored := IO0Result; 
Until criticalActionCode <> ’R’; 


Writeln (’After disk attempt, criticalErrorOccurred = ’, 
criticalErrorOccurred) ; 
Writeln (’ and criticalErrorCode = ’, criticalErrorCode) ; 
Writeln (’ and criticalErrorDrive = ’, criticalErrorDrive) ; 
Writeln (’ and criticalActionCode = ’, criticalActionCode) ; 
{$I+} 
End. 


{ clear system error status } 


End Listings 
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Parallel Programming for “C” 


INTERWORK™ 


A Concurrent Programming Toolkit 








































Interwork is a “C” program library which allows you to write 
your programs as a set of cooperating concurrent tasks. Very 
useful for simulation, real-time applications, and experimenta- 
tion with parallel programming. 


FEATURES 
¢ Supports a very large number of tasks (typically more than 
100) limited only by available memory. Low overhead per 
task results in very fast context switching. 
Provides a full set of inter-task communication (ITC) 
facilities, including shared memory, locks, semaphores, 
blocking queues, and UNIX™-style signals. Also has building 
blocks for constructing your own ITC facilities. 
Handles interrupts (DOS version) and integrates them into 
task scheduling. Supply your own interrupt handlers or 
block tasks on interrupts. 
Lets you trace task switches and inter-task communication. 
Comes with complete documentation including a user's 
manual and reference manual of commands. 


Interwork is available for the following systems: 


Operating System 
PC-DOS 2.0 or later 
IBM PC AT XENIX™ 

DEC VAX" SUN UNIX 4.2BSD 


PC-DOS version is compatible with DeSmet, Lattice, and 
Microsoft C compilers. 

Please specify hardware and operating system when order- 
ing. Shipping and handling included; COD orders add $2.50. 


Send check or money order to: 
Ae Block Island Technologies 
Innovative Computer Software 
13563 NW Cornell Road, Suite 230, Portland, Oregon 97229-5892 
(503) 241-8971 


Trademarks: Interwork, Block Island Technologies; UNIX, AT&T Bell Laboratories, Inc.: XENIX, 
Microsoft. Inc.; VAX, Digital Equipment Corporation 


Hardware 
IBM PC, XT, AT 
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PICOSPAN 


UNIX™ Conferencing Software 





A time-independent innovation in group 
communication: many to many, not one to one. 


User interface and built-in help 
facilities are easily customized. 


Fully integrated with UNIX and its tools. 


Train staff through on-line communication 
in the use of systems, computers, and UNIX. 


Provide consultation for users of your 
computer system or communication service. 


Increase productivity and avoid 
telephone tag in vital communications. 





Try PicoSpan on fishnet: For More Information: 

(305) 534-2422, 1200/300 baud. UniCon, Inc. 

login: help 120 Enterprise Drive. 
Ann Arbor, MI 48103 

Or call m-net: (313) 994-6333, (313) 996-CONF 


same procedure but busy system. 
TM - UNIX is a trademark of AT&T 
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Now you can use QPARSER + to develop compilers, 
interpreters, complex user-interfaces, language & file for- 
mat translators (i.e. Pascal to C, Bit Map to Postscript), 
language debuggers like lint, etc. | 


Develop language translators in C and Pascal within the 
IBM PC/XT/AT or VAX/VMS environments. A new user 
manual, automated syntax tree construction and an ad- 
vanced code generation language are just a few of the 
improvements over the original QPARSER. 





Another translation by QPARSER+ 
Just $475 (Pcav/aT) — FREE demo disk available 


QCAD Systems 


| 1164 Hyde Avenue, San esd CA 95129 (408) 727-6884 


Pp 9 BE a a 
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Cogent Prolog 



















o Fast, Compact, COMPILED Prolog 

o IBM PC and Compatibles 

Oo Clocksin & Mellish Standard, Plus 
Windows Strings 
Floating Point Modules 

o Window Based Development System 

o Context Sensitive Help 

o User Specifiable Error Handling 

o Interface to "C" and Assembler 

o Can Produce .EXE Files - No Royalties 


$200 


VISA - MasterCard - Check 
30 Day Money Back Guarantee 





Cogent Software, Ltd. 


21 William J. Heights 
Framingham, MA 01701 
(617) 875-6553 
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Listing One (Text begins on page 108.) 


**ee%% Listing 1 for TRACY, Feb ’88 *##**% 


( Stream data and text read and write } 
These utilities read and write streams of data and text from 
standard or BLOCKed files. 


Text lines are read into the user buffer until either the buffer 
is full, or the file is empty, or an #EOF or #EOL is read. 

The terminating #EOF or #EOL , if present, is not read into the 
buffer. #LF ({ linefeeds}) are read but ignored. 


Output files are assumed to be extensible. 


For your convenience, the Standard Prelude and DDJ Controlled 
Reference Word Set are duplicated in this file. 


{ LOAD screen for DDJ Standard Prelude and String Extension) 
{ MJT Nov 22 1987 for DDJ February 1987) 


{ 2 LOAD ( Standard prelude} 
3 LOAD ( Augmented interpretation) 
4 5 THRU { Controlled words} 


6 9 THRU ( Strings) 
10 13 THRU { General file support) 
\ 14 LOAD ( Read and write data files) 
15 16 THRU ( Read and write BLOCKed data files} 
17 LOAD ( Read text file, no #EOL) 
\ 18 LOAD ( Read text file, with #EOL) 


19 LOAD ( Write text file) 
20 22 THRU ( Some examples) 


_ 


FORTH-83 functions-- typical definitions) 
Adjust these words for your Forth. See DDJ Oct 1987.) 
{ Note: functions already provided need not be redefined.) 


~”~ 


: RECURSE [COMPILE] MYSELF ; IMMEDIATE 
: INTERPRET INTERPRET ; 

: I> ( -— ’data) COMPILE R> ; IMMEDIATE 
: >I ( — ’data) COMPILE >R ; IMMEDIATE 


-_ 


Used for alignment: } 
: ALIGN { HERE 1 AND ALLOT) ; 
: REALIGN (a-— a’ ) {( DUP 1 AND +) ; 


N 


CONSTANT CELL : CELL+ 2+ 3 : CELLS 2* 3; 


: UNDO I> R> R> 2DROP >I ; \ Undoes a DO— LOOP. 
{ Required definitions - used to support further compilation) 


: THRU ( n n2) 1+ SWAP DO I LOAD LOOP ; 
\ LOADS screens n through n2. 


i >IN @ 64 + -64 AND >IN ! ; IMMEDIATE 
\ comment to end of line. For use in screens only. 


& XX 1024 >IN ! ; IMMEDIATE 


\ stops interpreting or compiling screen immediately. 


e NIE (f-} O= IF [COMPILE] \ THEN ; IMMEDIATE 
\ conditional interpretation or compilation. 


NEED ( - f) 32 ( ie blank) WORD FIND SWAP DROP 0= ; 
true if the following word is in the search order. 
\ FORTH-83 Controlled Words 


ow 


NEED 2* \IF : 2* DUP +; 
NEED D2* \IF : D2* 2DUP D+ ; 


NEED HEX \IF : HEX 16 BASE ! ; 
WEED Cc, \IF =: Cc, (2 ) HERE 1 ALLOT C! ; 


NEED BL \IF 32 CONSTANT BL 


NEED ERASE \IF 
NEED BLANK \IF 


0O FILL ; 
BL FILL ; 


: ERASE ( a n) 
: BLANK ( a n} 


NEED .R \IF : .R ( n width) >R DUP O< R> D.R ; 


\ DDJ Forth Column Controlled Words 


NEED 2>R 
\IF : 2>R COMPILE SWAP COMPILE >R COMPILE >R ; IMMEDIATE 
NEED 2R> 
\IF : 2R> COMPILE R> COMPILE R> COMPILE SWAP ; IMMEDIATE 


NEED @EXECUTE \IF : @EXECUTE @ EXECUTE ; 

NEED AGAIN 

\IF : AGAIN O [COMPILE] LITERAL [COMPILE] UNTIL ; 

NEED DLITERAL 

DUP \IF : DLITERAL SWAP [COMPILE] LITERAL [COMPILE] LITERAL ; 
\IF IMMEDIATE 


IMMEDIATE 


NEED S>D \IF : S>D (n - d)} DUP O< ; 

NEED WITHIN \IF : WITHIN ( n n2 n3 —- £) OVER — >R - R> U< ; 
NEED TRUE \IF -1 CONSTANT TRUE ; 
\ String operators See DDJ December 1987 

\ Only /STRING and EVAL are used in this application. 


: /STRING ( an n2 —- atn2 n-n2) ROT OVER + ROT ROT - ; 
\ truncates leftmost n chars of string. n may be negative. 


: EVAL (an ) 
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\ evaluates ("text interprets”) a string. 
DUP >R TIB SWAP CMOVE R@ #TIB ! 
0 >IN ! 0 BLK ! INTERPRET R> >IN ! ; 


\\ String operators from STRINGS.ARC are summarized here: 


\ returns value of following character. 
\ converts character to string. 


ASCII ( - c) 
eto"? (“Ee = a2 1) 


SKIP (alc - a2 12) 

\ returns shorter string from first position unequal to byte. 
SCAN ( a l byte - a2 12) 

\ returns shorter string from first position equal to byte. 


" (- an) \ STATE-smart string literal. 


\\ String operators from STRINGS.ARC continue here: 

VAL? (an-dad2,n21, 0} 

\ string to number conversion primitive. True if d is valid. 
\ Returns d if number contains ",-./:" and sets DPL = 0 

\ Returns n if no punctuation present and sets DPL = 0< 


VAL (an-d f£) 

\ converts string to double number. True if number is valid. 
\ If number contains ",-./:" then sets DPL = 0 

\ If no punctuation present then sets DPL = 0< 


-TEXT (ana2--1,0, 1} 
\ returns -1 if string an < a2Qn, 0 if equal, and 1 if >. 


COMPARE (ana2n2--1,0, 1) 
\ returns -1 if an < a2 n2, O if equal, and 1 if >. 
\ The corrected version of MATCH 


: MATCH ( an a2 n2 —- ???? 0, offset -1) 
returns the position of string a2 n2 in (an). 
Offset is zero if (an) is found in first char position. 
Returns false with invalid offset if (an) isn’t in a2 n2. 
DUP 0= IF 2DROP 2DROP O TRUE EXIT THEN 
2SWAP 2 PICK OVER SWAP - 
DUP O< IF 2DROP 2DROP QO EXIT THEN 
0 ( index } SWAP 1+ 0 
DO {( index }) >R 
20VER 2O0VER DROP -TEXT 0= ( equal? } 
IF 2DROP 2DROP R> TRUE UNDO EXIT THEN 
1 /STRING R> 1+ 
LOOP 2DROP 2DROP 0 ; 


ee a oe 


\ Data stream general support 
1024 CONSTANT 1K 

: UMIN ( u u2 —- u3) 2DUP U< O= IF SWAP THEN DROP ; 
\ Adjust these constants for your system: 

10 CONSTANT #LF \ linefeed character. 

13 CONSTANT #EOL \ end-of-line character. 

26 CONSTANT #EOF \ end of file character (control-Z). 


\ Adjust end-of-line and end-of-file sequence for your system: 
CREATE ENDLINE 2 ( count) C, #EOL C, #LF C, 
CREATE ENDFILE 1 ( count) C, #EOF C, 


\ File size and position 
\ Example of some of the structure of a file control block: 


\ VARIABLE FCB HERE FCB ! 5 CELLS ALLOT {( Containing: } 
\ 1 cell current file handle-- ie selects current file. 
\ 2 cells current file size in bytes (double number). 

\ 2 cells current file position (double number). 

\\ You can implement CAPACITY and POSITION as 2VARIABLES. 

\\ You must initialize CAPACITY to the size of your file. 


2VARIABLE POSITION 
2VARIABLE CAPACITY ( eg DSIZE CAPACITY 2! ) 


we at 


Set and reset file position 
Given POSITION you can control the position of file access: 


MARKDATA ( - d) POSITION 2@ ; 
determines the position of the current file. 


a“ 0 


: SEEKDATA ( d } POSITION 2! ; 
\ changes the position of the current file. 


Extend the file 


at 


(continued on next page) 
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TOTAL CONTROL. 


with LMI FORTH" 


For Programming Professionals: 


an expanding family of 
compatible, high-performance, 


Forth-83 Standard compilers 
for microcomputers 


For Development: 
Interactive Forth-83 Interpreter/Compilers 


¢ 16-bit and 32-bit implementations 

Full screen editor and assembler 

Uses standard operating system files 

400 page manual written in plain English 

Options include software floating point, arithmetic 
coprocessor support, symbolic debugger, native code 
compilers, and graphics support 


For Applications: Forth-83 Metacompiler 


e Unique table-driven multi-pass Forth compiler 

¢ Compiles compact ROMable or disk-based applications 

e Excellent error handling 

e Produces headerless code, compiles from intermediate 
states, and performs conditional compilation 

e Cross-compiles to 8080, Z-80, 8086, 68000, 6502, 8051, 
8096, 1802, and 6303 

e No license fee or royalty for compiled applications 


For Speed: CForth Application Compiler 


e Translates “high-level” Forth into in-line, optimized 
machine code 
e Can generate ROMable code 


Support Services for registered users: 


e Technical Assistance Hotline 
e Periodic newsletters and low-cost updates 
e Bulletin Board System 


Call or write for detailed product information 
and prices. Consulting and Educational Services 
available by special arrangement. 


| , 

Laboratory Microsystems Incorporated 
Post Office Box 10430, Marina del Rey, CA 90295 
Phone credit card orders to: (213) 306-7412 





Overseas Distributors. 

Germany: Forth-Systeme Angelika Flesch, Titisee-Neustadt, 7651-1665 
UK: System Science Ltd., London, 01-248 0962 

France: Micro-Sigma S.A.R.L., Paris, (1) 42.65.95.16 

Japan: Southern Pacific Ltd., Yokohama, 045-314-9514 

Australia: Wave-onic Associates, Wilson, W.A., (09) 451-2946 
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Imagine! Developing and testing ROM software 
from your terminal in a matter of minutes. 
No more blasting ROMs! 


ROMulator™ Features: 

e Emulates standard (EDEC) 24 and 28 pin ROMs 

e 8, 16, and 32 bit word modes 

e Daisy chain modules for up to 8 unique ROMs 

¢ Non-volatile models retain software during power-down 


e As little as $325.00 per ROM 
e Models available up to 1 Mega-bit 





ASK US ABOUT FASTER ROMS AND CUSTOMIZING 
CABLES FOR OTHER ROM TYPES. 





@ranwagirag Grammar Engine, Inc. 
1021 Tipton Court 


Westerville, OH 43081 


Aree 614/882-6366 
VISA and MasterCard Accepted Aap call: 


Dealer Inquiries Welcome 
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OBJECT-ORIENTED PROGRAMMING IN C 


C talk” 









Whatis C talk 


C_talk™ is an object-oriented development environment in C with Smalitalktike messaging formats. It lets the 
software developer use the C_talk™ Browser to develop an object-oriented program, then use the C_talk™ Compiler 
to convert this program into C code compatible with most popular C compilers. The combined data abstraction power 
of object-oriented programming with the efficiency, speed, and flexibility of C results in a high productivity 
development and delivery environment which can significantly cut development time. C_talk™ offers: 


C_talk™ is designed to let you take full advantage of object-oriented languages (_OOLs). It is designed so that both 
the object-oriented guru and the “non-objecting’ neophyte can use C_talk™ to explore and exploit the exciting world 
of OOLs. C_talk™ contains: 

* Encapsulation ("objects") 





























* Messaging * Inheritance 


The Efficiency of C 


C_talk™ does just what its name suggests — lets you talk in C, and thereby gives you all the efficiency and advantages 
of C: 


+ Speed, Size, Flexibility + Ease of Application Delivery + Access to C libraries and C tool sets 


The user of standard C will find programming in C_talk™ is basically programming in C, but with a powerful 
difference: C_talk™ is an object-oriented environment. C_talk introduces to C a new data type — the object, and a 
new operation - the message. 


The Productivity of C_ talk’ 


C_talk™ is a synergy of C and Smalitalk-like features - yielding much greater productivity to the software builder: 


* Define software components in object-oriented terms. 

* Extend software components with full class-inheritance. 

* Automatically convert work into C code. 

« Reuse software components to obtain results in less time. 
+ Learn quickly using standard C in C_talk™. 


C_talk™ (version 1.0) is designed to run on the IBM® PC (or compatibles) with graphics (CGA, EGA, PGA) and with 
one of the following C languages: Microsoft® C, Lattice C, Turbo C, or C86. A system configured with a hard drive 
and mouse is highly recommended. 


CNS, Inc. 
Software Products Dept. 
7090 Shady Oak Road 
Eden Prairie, MN 55344 
(612) 944-0170 












PRICE; $149.95 

Credit Cards: Waster Card, Visa 
IBM is a registered trade mark of IBM Com. 
MICROSOFT is a registered trade mark 


of MICROSOFT CORP. 
C_tak is a trade mark of CNS, inc 
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THE FORTH COLUMN 


Listing One 
(Listing continued, text begins on page 108.) 





\ If your Forth or operating system requires explicit extension, 
\ supply an appropriate definition for EXTEND . 
\ Otherwise, use : EXTEND ( d )} COMPILE 2DROP ; IMMEDIATE 


: EXTEND ( d ) COMPILE 2DROP ; IMMEDIATE 

\\ 

: EXTEND ( d ) 

\ properly extends current file by d bytes. 

\ This example converts d to blocks and calls a MORE function. 
1K UM/MOD SWAP IF 1+ THEN ( # of blocks to extend ) MORE ; 


\ Read and write data files directly 


: GETDATA ( an - n2) : 

\ reads n bytes of data from input file into address, n < 64K 
\ Returns n2 bytes not read ( ie beyond end of file). 

\ Implement as a system call using CAPACITY and POSITION 


: PUTDATA ( a n) ; 
\ writes n bytes of data to output file from address, n < 64K 
\ Implement as a system call using CAPACITY POSITION and EXTEND 


\ Read BLOCKed file as data file 


: GETDATA ( an - n2} 
\ reads n bytes of data from input file into address, n < 64K 
\ Returns n2 bytes not read ( ie beyond end of file ). 
( calculate # of bytes to move < 64K : }) POSITION 2@ 
BEGIN 2 PICK (nn) DUP 
IF (mn) >R 2DUP 1K UM/MOD SWAP DROP 1+ 1K UM* 
CAPACITY 2@ DMIN 2O0VER D- 0= NOT OR R> UMIN 
THEN ?DUP 
WHILE >R 2DUP 1K UM/MOD BLOCK + 
R@ 0 D+ 2SWAP R> /STRING 2SWAP 
REPEAT POSITION 2! SWAP DROP ; 


4 PICK R@ CMOVE 


\ Write BLOCKed file as data file 


: PUTDATA { a n) 
\ writes n bytes of data to output file from address, n < 64K 
{ extend the file as needed : ) 
DUP 0 POSITION 2@ D+ CAPACITY 2@ 2SWAP D- DUP O0< 
IF 2DUP EXTEND 20VER CAPACITY 2! THEN 2DROP 
( calculate # of bytes to move < 64K : ) POSITION 2@ 
BEGIN 2 PICK (nn) DUP 
IF (nn } >R 2DUP 1K UM/MOD SWAP DROP 1+ 1K UM* 
CAPACITY 2@ DMIN 20VER D- 0= NOT OR R> UMIN 
THEN ?DUP 
WHILE >R 2DUP 1K UM/MOD BLOCK + 
R@ 0 D+ 2SWAP R> /STRING 2SWAP 
REPEAT POSITION 2! 2DROP ; 


4 PICK SWAP R@ CMOVE 
UPDATE 


\ Read text file with #EOF 


GETTEXT (an - n2 f) 
reads n bytes of text from input file into address, n < 64K 
Returns n2 bytes not read ( ie end-of-line or beyond file) 
Returns true if #EOL terminates line; false otherwise. : 
POSITION 2@ CAPACITY 2@ 20VER D- 0= NOT OR ( limit to 64K) 
3 PICK UMIN ?DUP O0= IF 2DROP SWAP DROP 0O EXIT THEN 0 
DO 2DUP 1 0 D+ 2SWAP 1K UM/MOD BLOCK + C@ ( read a char } 
DUP #EOL = OVER #EOF = OR 
IF >R POSITION 2! SWAP DROP R> #EOL = UNDO EXIT THEN 
DUP #LF - (an dpos ch f ) 
IF >R 2SWAP R@ 2 PICK C! 
DROP 
LOOP POSITION 2! 


Go a ig we 


1 /STRING 2SWAP R> THEN 


SWAP DROP 0 ; 


\ Read text file without #EOF 


GETTEXT ( an - n2 f) 

reads n bytes of text from input file inte address, n < 64K 
Returns n2 bytes not read ( ie end-of-line or beyond file) 

Returns true if #EOL terminates line; false otherwise. 
POSITION 2@ CAPACITY 2@ 20VER D- 0= NOT OR ( limit to 64K) 


a = gt de 


3 PICK UMIN ?DUP O= IF 2DROP SWAP DROP 0O EXIT THEN OO 
DO 2DUP 1 0 D+ 2SWAP 1K UM/MOD BLOCK + C@ ( read a char }) 
DUP #EOL = 
IF >R POSITION 2! SWAP DROP R> #EOL = UNDO EXIT THEN 
DUP #LF - (an dpos ch f } 
IF >R 2SWAP R@ 2 PICK C! 1 /STRING 2SWAP R> THEN 
DROP 


LOOP POSITION 2! SWAP DROP 0 ; 


\ Read and write lines of text 
GETLINE (an-an2 f) 
reads n bytes of text from input file into address, n < 64K 
n2 bytes are actually read; this is the opposite of GETTEXT 
Returns true if #EOL terminates line; false otherwise. 

2DUP GETTEXT >R - DUP O= O= R> OR; 


i an i 


: PUTLINE (an ) PUTDATA ENDLINE COUNT PUTDATA ; 
\ writes n bytes of data to output file from address, n < 64K 


Dr. Dobb's Journal, February 1988 


+ 386 + 386 - 386 + 386 + 386 » 386 + 386 + 386 +» 386 + 386 - 386 + 386 » 







G 
Pascal 


Text stream examples 





: TYPE-FILE \ reads and prints the input text file. 
Assumes zero-length string TYPEs nothing. 
SWITCH ( to input file saving currently active file) 
BEGIN PAD 80 GETLINE ({ n2 f) 
WHILE CR TYPE REPEAT 2DROP 
SWITCH ( back to current file) ; 


Paradox 386 
Foxbase+ 386 
386-MATLAB,/Weitek 


... and others ... 


These and other protected-mode 32-bit 80386 programs are 
among the first to take advantage of the full power of the 386. 
They and practically every 386 protected-mode MS-DOS 
program that's shipping were done with MetaWare's compilers. 


: COPY-FILE 
copies the input text file to the output text file. 
Save and restore current file as needed. 
BEGIN SWITCH ( to input file) PAD 80 GETLINE 
SWITCH ( to output file) 
WHILE PUTLINE REPEAT 2DROP ENDFILE COUNT PUTDATA ; 


Text stream examples 
: BLOCK-TO-TEXT 
copies the input BLOCK file to the output text file. 
Save and restore current file as needed. 
BEGIN SWITCH { to input file) PAD 64 GETLINE 
SWITCH ( to output file) 
WHILE -TRAILING PUTLINE 
REPEAT 2DROP ENDFILE COUNT PUTDATA ; 


It's no surprise. The recognized leader, MetaWare introduced the 
first C and Pascal compilers that generate protected-mode 386 
code for running on any 386 MS-DOS machine (e.g., the Compaq 
386 or the IBM PS/2-80) over a year ago. High C ™ and 
Professional Pascal ™ are well-established and proven. 


: TEXT-TO-BLOCK 0 ( previous line length ) 
copies the input text file to the output BLOCK file. 
BEGIN SWITCH ( to input file) 
PAD 64 2DUP BLANK GETLINE ROT {( a } DROP 
SWITCH ( to output file) 
WHILE DUP O0= ROT 64 = AND NOT IF PAD 64 PUTDATA THEN 
REPEAT 2DROP ; 
Text stream examples 


Smart software developers aren't waiting! \ndustry leaders such 
as Borland (ANSA) and Fox use MetaWare's compilers to get dra- 
matic increases in speed and functionality. Don't wait years for 
Microsoft's 386DOS—your competition will have a big jump on you! 


Expand your application to the large 32-bit address space and the 
full 32-bit registers of the 80386. Go with the long-standing leader. 
Contact MetaWare for your 80386 software solution today! 


(408)429-6382 telex 493-0879 


Wats ara" 


: EVAL-FILE \ reads and interprets the input text file. 
Assumes zero-length interpreted string does nothing. 
SWITCH ( to input file saving currently active file) 
BEGIN PAD 80 GETLINE ( n2 f) 
WHILE EVAL REPEAT 2DROP 
SWITCH ( back to current file) ; 





INCORPORATED 


903 Pacific Avenue, Suite 201 * Santa Cruz, CA 95060 
The Clear Choice for Large Programming Projects —ec tecn sm 
* OBE + OBE + OBE - OBE + OBE + OBE - OBE > OBE » OBE » OBE > OBE + OBE - 
CIRCLE NO. 162 ON READER SERVICE CARD 
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copy protection and 
customer satisfaction? 


here's a better way to protect your software. 
ts called the Secom Key, and it works, or more information, contact 


L) ™ Key is completely transparent to the Secom Information Products Co 
end user. 


iv ; - — 500 Franklin Square 
(_) Won't interfere with peripheral operations. “ a «1829 East Franklin Street 


[_) Doesn’t occupy the disk drive. a : | : Sgr Nao 
_) The Key allows unlimited backup copies. | BB thesecomKey.. 


(_} Makes site licensing easy and auditable. .. : pens 
(_) Fasily installed. Uses only 1000 bytes. _ i sien 
[_} Over 60,000 have been sold worldwide. , , 
(_} Same size as RS-232 plug. 


(_} Available in quantities for as low as $19.95. Secom Information Products Company 


A Subsidiary of Secom General Corporation 


Call Toll-free 1-800-843-0413 





CIRCLE NO. 163 ON READER SERVICE CARD 
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Dr. Dobb’s 
Teolbook of C 

by the Editors of 

Dr. Dobb’s Journal of 
Software Tools 





This authoritative reference contains over 700 pages of the best C 
articles and source code from Dr. Dobb’s Journal of Software Tools, 
along with new material by C experts. You'll find hundreds of pages of 
useful C source code, including a complete compiler, an assembler, and 
text-processing utilities. 


Book 


Item #615-3 $29.95 


The Small-¢C Compiler 
and Smalli-C 

c Handbook 
Anon by James E.Hendrix 


aon 






a 


This compiler and handbook provide everything you need for learning 
how compilers are constructed, and for learning C at its most 
fundamental level. You'll find a discussion of assembly language 
concepts and program translation tools, and learn how to generate a 
new version of the compiler. Full source code is included. The handbook 
and compiler on disk are available for both MS-DOS and CP/M systems. 
The handbook comes with an addendum for the MS-DOS version. Please 
specify format. 


Book & Disk (MS-DOS) item #76-3 $42.90 
Book & Disk (CP/M) item #67-4 $37.90 
Small-Mae: 


An Assembler for 
Small-C 
by James E. Hendrix 





This assembler features simplicity, portability, adaptability, and 
educational value. The package includes: a simplified macro facility; C 
language expression operators; object file visibility; descriptive error 
messages; an externally defined instruction table. You get the macro 
assembler, linkage editor, load-and-go loader, library manager, CPU 
configuration utility, and a utility to dump relocatable files. Documentation 
is included. For CP/M systems only. Please specify format. 


Manual & Disk (CP/M) item #77-1 $29.95 


CP/M C Pack 





Receive: Dr. Dobb’s Toolb x 
Compiler, Small-Mac Asse 
Programs. Only $99.95! — 


MS-DOS C Pe 

Receive: Dr. Dobb's Toolb 
Addendum, the Small-C C 
Text Processing Programs. Only: 
MS-DOS C Package _ite 


¢ Disk Formats: Please specify MS-DOS or CP/M. For CP/ 
M, specify: Apple, Kaypro, Osborne, Zenith Z-100 DS/ 
DD, 8” $$/SD 


Small-Windows: 
A Library of 
Windowing 
Functions for the C 
Language 

by James E. Hendrix 





Small-Windows is a complete windowing library for C (Microsoft 
4.0 and Small-C). The package includes: 18 video functions written in 
assembly language, 7 menu functions that support both static and pop- 
up menus, 41 window functions to clean, frame, move, hide, show, scroll, 
push, and pop windows. Two test programs are provided as examples to 
show you how to use the library and the window, menu, and directory 
functions. Documentation and full C source code is included. Available 
for MS-DOS systems for the following compilers: Microsoft C Version 4.0, 
Small-C, Lattice C and Turbo C. Please specify compiler format. 


Manual & Disk (MS-DOS) item #35-6 $29.95 


Small-Tools: 
Programs for Text 
Processing 


by James E. Hendrix 





This package of programs performs specific, modular operations on 
text files, including: editing; formatting; sorting; merging; listing; printing; 
searching; changing; transliterating; copying; concatenating; encrypting 
and decrypting; replacing spaces with tabs and tabs with spaces; 
counting characters, words, or lines; and selecting printer fonts. Small- 
Tools is supplied in source code form. With the Small-C Compiler, you 
can select and adapt these tools to your own purposes. Documentation 
? also included. Available for MS-DOS or CP/M systems. Please specify 
ormat. 


Manual & Disk (MS-DOS or CP/M) item#78-X $29.95 



















C Tools From 
M&T Books 


C Chest and Other 
| € Treasures 





from 
Dr. Dobb’s Journal 
by Allen Holub 
This comprehensive anthology contains the popular ”C Chest” e 

columns from Dr Dobb’s Journal of Software Tools, along with the lively To Order: 
philosophical and practical discussions they inspired, in addition to other Return this order form with your payment to: M&T Books, 
lg snp byC oer . 501 Galveston Dr., Redwood City, CA 94063 
opics covered include: pipes, wild-card expansion, and quote 
arguments; sorting routines; command-line processing; queues and bit Or, CALL TOLL-FREE 800-533-4372 
maps; utilities such as /s, make, and more, expression parsing: Mon-Fri 8AM-5PM 
hyphenation; IBM cursor control and an Fget that edits; redirection: - (In CA call 800-356-2002) 


accessing IBM video display memory; trees; an AVL tree database 
plckage; directory traversal: sets: shrinking .EXE file images; hashing, = 

expressions, and Roman numerals; and statistical applications of digital a 
low-pass filters. ite t+sis 
All subroutines and programs are written in C and are available on disk 


with full C source code. MS-DOS format. @RBER eo re Ra 

















Book & Disk (MS-DOS) Item #49-6 $39.95 
Book Item #40-2 $24.95 Name 
Address 
City State Zip 
Item # Description Price 


Turbo C: The Art 
Program Design, 
of Advanced 
Optimization 











oS 
and Debugging Subtotal 
. : ce) 
by Stephen R. Davis CA residents add sales tax_ % 
Add $2.25 per item for shipping 
Overflowing with example programs this book fully describes the TOTAL 
techniques necessary to skillfully program, optimize and debug in Turbo =—Ssa go Disk Orders, please indicate format. Refer to product description 
C. Every topic and Turbo C feature discussed is fully demonstrated in _____ for standard format availability. 
Turbo C source code examples. Advanced topics such as pointers; _ 
direct screen I/O; inline statements in Turbo C; and how to intercept and [_] MS-DOS CP/M: [] Kaypro [ 8” SS/SD [_] Osborne 


redirect BIOS calls are all covered indepth. The author further [_] Apple [] Zenith Z-100 DS/DD 
demostrates these advanced topics by writing a RAM resident pop-up 

program in Turbo C. Learn about the differences between Unix C and 
Turbo C, about the transition from Turbo Pascal to Turbo C, and about 


For Small-Windows, indicate: 
[_] Microsoft version 4.0 compiler [_] Lattice C 3.0 compiler 








the superset of K&R C features implemented in Turbo C and includedin = L] SmallC compiler [_] Turbo C compiler 
the proposed ANSI C standard. = les 
Book & Disk (MS-DOS) Item #45-3 $39.95 . [_] Check enclosed. Make payable to M&T Publishing. 
Book item #38-0 $24.95 Charge my[_] VISA [ ] M/C [|] Am. Ex. 
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COLUMNS 


C GHEST 


Hiding Configuration Information 


toring a program's configuration 

information—variables that can 
be changed by users but that must 
retain their values between succes- 
sive program invocations—is a 
common problem. An easy solution 
is to use a configuration file that’s 
read in by the program when it 
boots. 

Configuration files have problems, 
though. The first one is finding the 
file. Many programs require the con- 
figuration file to be in the current 
directory. If you're going to execute 
the program in more than one direc- 
tory, you need a configuration file 
in each of these directories. Clearly 
this behavior isn’t really acceptable. 
Not only do you start filling up your 
disk with unnecessary files but also 
the files can get out of sync with 
each other—if you make a change 
to one, you have to make a change 
to all of them. 

There are other solutions, how- 
ever. First, you can search for the 
file along the PATH. Example 1, page 
95, shows a search-for-file subrou- 
tine that can be used for this pur- 
pose. It’s passed two strings—the 
first containing a file name, and the 
second the name of an environment 
that holds the search path (a semi- 
colon-delimited list of directories). 
The search() subroutine looks for 
the file, first in the current directory, 
and then in all the directories listed 
in the given environment string. If 
the file is found, search() returns a 
pointer to the full path name; other- 
wise it returns NULL. 


by Allen Holub 


The access() subroutine that 
search() uses is a Unix function that 
looks at the permission mask associ- 
ated with a file. You can use it to 
test for read permission, write per- 
mission, and so forth. Here, I’m just 
using it to test for existence. If you 
don't have an access() function, you 
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can do the same thing by trying to 
open() the file for read and looking 
to see if open() returned an error (if 
it did, the file didn't exist). 

The strpbrk (char *src, char *pat) 
function searches the src string for 
any of the characters in the pat 
string and returns a pointer to that 
character if found (NULL if not). The 
strtok (char *src, char *delim) func- 
tion extracts a series of tokens from 
the src string. Tokens are delimited 
by any of the characters in the delim 
string. The first time the subroutine 
is called, it returns the first token 
from the string. In subsequent calls, 
the first argument is set to NULL, 
and it returns subsequent tokens 
from the original string. It returns 
NULL when there are no more 
tokens. 

The getenv() function returns the 
contents of the indicated environ- 
ment. This string has to be copied 
to pbufl] because it’s modified by 
the subsequent strtok() calls. 
Strpbrk(), strtok(), and getenv() are 
all ANSI functions, so they should 
be in your compiler’s library. 

Another alternative to searching 
along the PATH is provided by some 
compilers, such as Microsoft's. 
These compilers provide the full 
path name of the executable file in 
argvl0). You can then require the 
configuration file to be in the direc- 
tory as the executable file. 

A third (and, I think, the best) 
alternative is to dispense with the 
configuration file entirely and to in- 
corporate the configuration informa- 
tion in the -EXE file itself. This way, 
you don't clutter up the disk with 
needless files whose immediate pur- 


pose is not obvious. To use the .EXE 
file, you have to find it on the disk, 
using either of the methods dis- 
cussed earlier. You also have to de- 
clare a structure in your program 
that will contain the modifiable op- 
tions. At very least this structure 
must contain a signature field and a 
checksum. The signature contains 
an arbitrary, but unchanging, string 
that you can look at to see if the 
options are valid. 

A stripped-down options struc- 
ture (called Opts) is shown in Exam- 
ple 2, page 96. The Microsoft com- 
piler correctly evaluates 
sizeof(DEF__SIG) as the number of 
characters in the string (including 
the \0). I can’t vouch for other com- 
pilers, though. Because the length is 
used in a declaration, you can use a 
strlen() call to compute it (because 
it’s executed at run time, not com- 
pile time). Consequently, if your com- 
piler’s sizeof doesn’t work correctly, 
you'll have to count the characters 
in the signature string to declare the 
array. 

Options are fetched from the .EXE 
file with a call to get__opts( argv/O0] ) 
at the head of my main() subrou- 
tine. Here, argv/0) holds the full path 
name of the .EXE file. If this is the 
first time that the program is exe- 
cuted, get__opts() creates (and in- 
itializes) the options area in the file. 
Get__opts() is shown in Example 3, 
page 96. 

Options are stored at the end of 
the .EXE file, following any execut- 
able code. The -EXE file is opened 
for binary-mode read on line 14. I 
then seek to what ought to be the 
beginning of the options area on 
line 20. That is, the options are at 
the end of the file, so I seek to end 
of file less the size of the Opt struc- 
ture. The structure is loaded on line 
22. Now I look at the signature (on 
line 25). If it doesn’t match, I assume 
that this is the first time that the 
program has been run, in which 
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10 important Reasons 


C Programmers Use 





1. It’s written in C. 

Clearly the growing language of 
choice for applications that are fast, 
portable and efficient. All of 
db__VISTA’s source code is written in C. 


- 2. It's fast — almost 3 times faster 
than a leading competitor. 

Fast access that comes from the 

unique combination of the B-tree 
indexing method and the “network” or 
direct “set” relationships between 
records. A winning combination for 
fast performance. 


3. It’s flexible. 

Because of db__VISTA’s combination 
of access methods, you can program 
to your application needs with ultimate 
design flexibility. Use db__VISTA as an 
ISAM file manager or to design 
database applications. You decide 
how to optimize run-time 
performance. No other tool gives you 
this flexibility without sacrificing 
performance. 

db_ VISTA is also well behaved to 
work with most any other C libraries! 


4. It’s portable. 

db_ VISTA operates on most popular 
computers and operating systems like 
UNIX, MS-DOS and VMS. You can 
write applications for micros, minis, or 
even mainframes. 


5. Complete Source Code 
available. 

We make our entire C Source Code 
available so you can optimize 
performance or port to new 
environments yourself. 


6. It uses space efficiently. 
db__VISTA lets you precisely define 
relationships to minimize redundant 
data. It is non-RAM resident; only 
those functions necessary for opera- 
tion become part of the run-time 
program. 


7. Royalty free run-time. 

Whether you’re developing applications 
for yourself or for thousands, you pay 
for db__VISTA or db__ QUERY only 
once. If you currently pay royalties to 
someone else for your hard work, isn’t 


it time you switched to royalty-free 
db_ VISTA? 





8.db_QUERY & db_REVISE. 
Add the SQL-based, ad hoc query and 
report writer for a relational view of 
db_ VISTA databases. 

Use db_REVISE to re-design your 
database easily and quickly! 

Both royalty free! 


9. Free tech support. 

60 days of free technical and application 
development support for every Raima 
product. Of course, extended support 
and training classes are also available 
at your place or ours. 


“wy 


Our File Manager 


10. Upward database 
compatibility 

Start out with file managementina 
single-user PC environment—then 
move up toa multi-user LAN ora VAX 
database application with millions of 
records. You'll still be using db__VISTA. 
That’s why so many C programmers 
are choosing db__VISTA. 


You farget one... 


WL bite training class 


VA pine ths pn 3A 
Lays Bases 
internals. 
rot Now! yi ow Uf ove 
olevelopment costs 


April 115, 


30-day Money Back Guarantee! 
Try db__VISTA in your environment 
for 30 days and prove it to yourself. If 
not completely satisfied, return it fora 


a lot! 


Price Schedule db_vista db_QueRY 
$ 195 


CL Single user $ 195 
LI Single user w/Source $ 495 $ 495 
CJ Multi-user $ 495 $ 495 
L) Multi-user w/Source $ 990 $ 990 
NEW: 

CL) VAX Multi-user $ 990 $ 990 
CL) VAX Multi-user w/Source $1980 $1980 
Order Now. 


Put db_VISTA to work in your 
application program. Ordering is 
easy—simply call toll-free. We'll answer 
your technical questions and get you 
started. Call today. 


Call Toll-Free Today! 
1 (800) db-RAIMA 
(800/327-2462) or 
206/828-4636 


DDJ 2/88 





RAIMA” 


CORPORATION 





3055 - 112th NE, Bellevue, WA 98004 USA 
(206) 828-4636 Telex: 6503018237 MCI UW 








Software 
Tools 





FULL 12 VOLUME SET $345.00 
Receive the entire 12 volume set of Dr. Dobb’s 


Bound Volumes, including 12 years worth of 
useful source code for only $345! You save 


over $60! 
S02. 


item # 93-3 


Volume 12 - 1987 

Building better brains. DDJ broke new ground 
in 1987 with a neural network implementation, 
monthly coverage of artificial intelligence and 
object-oriented programming techniques, and 
reviews of implementations of Prolog, LISP, and 
Smalltalk. We also evaluated the new BASICs, 
the proposed ANSI C standard, and the new 
optimizing C compilers, and we delivered 
practical utilities in C, Pascal, Forth, and 
assembly language. We gave our readers a 
UNIX BBS, an implementation of the nroff text 
editor, an extension to Appletalk, and an 
extended COM port driver. DDJ also described 
how 2-dimensional graphics can be displayed 
in 3-D. We showed how to create Macintosh 
Buttons, Amiga Gadgets, and DOS device 
drivers. And, as always, we delivered more 
useful code than any other magazine. 


item # 84-4 “$39.85. $35.75 


Volume 1 - 1976 
Always pertinent for bit crunching and byte 
saving, home-brew computer projects, and the 
technical history of home computing. Topics 
include: Tiny BASIC, the first words on CP/M, 
speech synthesis, floating point routines, the 
6502 disassembler for the Apple, and much 
more. 

item #13-5 


Volume 2 - 1977 

The small computer emerges as a powerful tool 
for the modern age in these issues from 1977. 
Topics include: Lawrence Livermore Lab's 
BASIC, Dr. Starkweather’s PILOT, using a 
modem, string- handling techniques, ciphers, 
Turtle graphics, and micro utilities. 

litem #16-X $30.75 


Volume 3 - 1978 

Explores the foundation of the mass-market 
computer industry in 1978. Topics include: 
programming in BASIC, PILOT, and Pascal; 
RAM memory testers; Apple utility programs; 
the S-100 bus standard; STRUBAL; anda 
structured BASIC compiler. 

item #17-8 $30.75 


Volume 4 - 1979 

Innovative ideas and articles guide the reader 
through the age of discovery in 1979. Topics 
include: selecting business software, 
microcomputer speech and music, information 
networks, and interfacing techniques. 

Hem #14-3 $30.75 


$345 


$30.75 


Dr. Dobb’s 

Bound 
Volume 12 
$3979E. $35.75 


Volume 5 - 1980 

Focuses on the technological promise of the 
modern microcomputer. Topics include: the 
revolutionary impact of CP/M, C programming 
and the UNIX operating systems, a survey of 
computer networks, software portability, 
introduction to Forth, and compiler writing. 
tem #18-6 $30.75 


Volume 6 - 1981 

The microcomputer enters the mainstream. 
Topics include: computer conferencing, the 
power of Forth, 8- and 16-bit technology, 
Rubik’s cube simulator, and an adventure 
game development system. 

item #19-4 $30.75 


Volume 7 - 1982 

Examines the potential of powerful 16-bit 
micros. Topics include: in-depth coverage of 
Forth, 68000, 8088 programming, C software 
tools, utilities for CP/M - including a spelling 
checker, using bulletin boards, and more. 
item #20-8 $35.75 


Volume 8 - 1983 

DDJ turns pro. Some of the most powerful 
professional programmer's tools ever 
published in a magazine are in this 1983 
volume, including Small-C, the RED editor, and 
an Ada subset. 


item #00-3 $35.75 


Name 

Address 

City 

[_] Vol. 1 $30.75 
[_] Vol. 2 $30.75 
[]Vol.3 $30.75 
[_] Vol. 4 $30.75 
[] Vol. 5 $30.75 
[]Vol.6 $30.75 


Charge my [| VISA [ | M/C 


© 
@ 
a. 
+ 


FULL 12 
VOLUME SET 


G4OL. $345. 








(In U.S., add $3.25 per book, $22 per 12 Volume set) 
(Outside U.S., add $6.75 per book foreign surface) 


CA residents add approporiate sales tax 


[_] Check enclosed. Make payable to M&T Books. 






Volume 10 - 1985 
The year of living dangerously. In 1985 DDJ 
added more memory, an SCSI port, and a hard : 
disk to the Macintosh; challenged the UNIX 
establishment with plans for a free UNIX. 
Includes software tools in C, Modula-2, Forth, 
Pascal, assembly language, and Prolog. 
item #21-6 $35.75 


Volume 9 - 1984 

In 1984 DDJ examined new programming 
environments Prolog, expert systems, Modula- 
2, and Pascal. Other topics include GREP, 
UNIX internals, and two encryptions systems. 
item 408-9 $35.75 


Volume 11 - 1986 

The promise of power. DDJ covered 1986's 

changes with issues on the 68000, parallel ‘ 
processing, artificial intelligence, the 80386, 

and multitasking. DDJ also supported the new 


= 


chips with assemblers, translators, and other 
development tools. 
item #31-3 $35.75 


To Order: 


Return this Order Form with your payment to: 
M&T Books, 501 Galveston Drive, 

Redwood City, CA 94063. 

Or, CALL TOLL-FREE 800-533-4372 
(in CA 800-356-2002.) 











& 

&. 

State Zip a 
[_] Vol. 7 $35.75 - 
[_] Vol. 8 $35.75 2 
[_] Vol. 9 $35.75 a 
[]Vol.10 $35.75 
[]Vol.11 $35.75 
[]Vol.12 $35.75 u 
C]vol. 1-12 $345 ey 
Subtotal 2 

% ay 

Shipping | 

TOTAL 2 

[_] Amer. Exp. oo 
Exp.Date i 
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7 extern char *strpbrk({), /* Library routines */ 
(continued from page 92) loliecarh 
fener ime *getenv(); 
case the options wont exist y et. So, static char *search( file, env_name ) 
I initialize the Opt structure myself gee ray ea 
i ies /* Search for file by looking in the directories 
on lines 27-38. : listed in the env_name environment. 
A checksum for the structure is Return a pointer to the full path name if you 
: find it (NULL if you don’t). The returned string 
computed on line 39-42. The check- is transient; it will be modified by the next 
sum is the negative sum of the other Sali to searchO 
. + . x 
bytes in the structure. That is, if you / 
: Static char pathname [80]; 
add up the contents of the entire . Seria: 
area occupied by the structure (in- char *D: 
cluding the checksum), you'll get 0. strcepy( pathname, file ); 
The checksum has two purposes: if( access( pathname, 0 ) != -1 ) 


return pathname; 


obviously, it can be used for check- 
ing the validity of the data in the 
structure itself; it also keeps DOS 
happy because every .EXE file also 
has a checksum. The structure’s 


/* The file doesn’t exist in the current directory. 
* If a specific path was requested (ie. if 

* file contains the characters \ or /) or if 

* the PATH environment isn’t set, return a NULL: 

* 
* 


else search for the file along the path. 


local checksum cancels any effect . a gh Sie aan ag 
that the rest of the structure’s con- strnepy( pbuf, p, 129 ); 
tents would have on the .EXE file ie) > atrcox( chor, <:* ) 5 
checksum. That is, because the sum ‘ . 
; 

of all the bytes sa the Se 1s 0; sprintf(pathname, "%$0.50s\\%0.20s", 
the presence or modification of the p, file ); 
structure won't change the file’s if( access( pathname, 0 ) >= 0 ) 
checksum return pathname; 

I seek to end of file and write out ee 
the initialized options area on lines eo 





43-48. I #ifndefed out the actual 
write() call when I'm debugging be- | Example 1: Search() 
cause CodeView, as it also puts stuff : 
at the end of the -EXE file, gets 
confused if it can't find its own in- What have YOU been missing? 
formation there. That is, it thinks 
that there’s no debugging informa- 
tion if I add my own data to the end 
of the file. 

If any options were changed 





CFlow™: Determine program 
hierarchy, external R/T 
library functions, etc.; 

CLint™: More rigorously check 


during the run, the options area in Pr ogrammer 'S CPrint™: Beautify ea 

the .EXE file is updated when the A Wiyt) lore, erhesai te dias 
program terminates with a call to Volumes I & IJ selected formats: 
put__opts(argv/l0)), where again CXref™: Cross reference and 
argvl0) holds the full path name of check symbol usage; 
the .EXE file. Put__opts() is shown CritPath™: Determine a program's 


in Example 4, page 96. It opens the 
.EXE file and then recomputes the 
checksum to reflect the changes 
made during the run. The routine 
then seeks in the file to the begin- 
ning of the options space (which 


Critical path; 
Create better, faster, higher quality | PMon™: —§ Monitor program/OS 
and easier to read programs in a execution; and more... 
fraction of the time. Let your J At $79.95 per volume or $130 for 
system do the work for you. With | both with a 30 day money back 
23 powerful, state of the art tools | guarantee, the Toolbox is simply the 


must exist) and writes out the modi- for the IBM PC and compatibles, | best value today. The Toolbox works 
fied structure. Again, I # ifdef out the both beginners and experts will find | with your existing C compiler(s) and 
actual write if I'm debugging to keep programming a breeze. enhances your development 
CodeView happy. Easy to use. Unlimited program | environment. 


sizes. Online documentation... Call and Order Today 
"Visa, MasterCard Accepted 


Nifty Stuff: awk 

awk, in addition to being a flightless, 
seagoing bird and the sound made MMC AD Systems 

by that bird, is one of the more Box 360845 Milpitas, California 95035 


useful tools in the Unix toolbox. 
Many (perhaps most) programs do Bs tip lov 
te 
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nothing but manipulate or verify 
data. Filter programs, such as grep, 
sed, pr, and so forth, just output a 
shuffled around version of an input 
file. Other programs, such as data- 
base report generators, shuffle 
around a database and output parts 
of it in an ASCII representation. 
Though none of these programs are 
particularly hard to write, it’s a nui- 


#include <stdio.h> 
#include <fcntl.h> 


#define DEF SIG 
struct options 
{ 


char 


sance to write a hoard of special- 
purpose programs in a language 
such as C—especially if you're going 
to use that program once and throw 
it away. 

awk provides a solution to this 
problem. It is essentially a dialect of 
C that’s optimized for text process- 
ing—a general-purpose tool from 
which other tools can be built. It 
supports all the C operators and 
control-flow statements (even recur- 
sion), though the operators have 


"(C) 1987, Allen I. Holub. All rights reserved." 


been extended to work with strings. 


For example: 


if( “aardvark” < “zebra” ) 

evaluates to true. 

awk programs all take the form 
expression { action }, where the ex- 
pression tells awk when to apply 
the action. That is, the action can 
be applied on every line, on a range 
of lines, a group of lines delimited 
by a specific string, on every line 
that contains a match for a regular 
expression, on every line that has a 
specific string or number in a spe- 
cific field, and so forth. The action 
can be a simple printfl) statement 
(printf() is an awk primitive) or a 





1 
2 
3 
4 
) 
6 
7 
8 
9 


Hh 
NFO 


13] 
14| 
15] 


signature[ sizeof(DEF SIG) ]; 

int chksum; 

[RRR RRR RE RE KEKRE RR ERK EKER ERE KEKE RE REE RRR RKKKEEEE / 
/* This structure also contains fields for every */ 


/* option that the user can change at run time. */ 
[RRR RRR IRKEEKREREKRKEKREKE RRR RER RE REE KEK KER KEKE / 


complex program that does elabo- 
rate database manipulation. Most of 
the familiar C constructs are avail- 


} 
Opt ; 


Example 2: Options header 








1| get_opts( name ) 
2| char *name; 
3{| { 
4| /* Various statistics (such as last time the program was 
5] * run) are stored in a buffer at the end of the 
6| * executable file. These stats are all stored in a 
7\ * “options” structure. This subroutine creates the data 
8 | * area if it doesn’t exist and initializes Opt as 
9] * appropriate. / 
10] 
11] int fd; 
12} int i, *p: /* Used to create checksum */ 
13| 
14] if( (fd = open( name , O_RDWR | O BINARY )) == -1 ) 
15| { 
16| perror ( name ); 
17| exit ti ): 
18| } 
19] 
20| lseek ( fd, OL - sizeof(Opt), SEEK_END ): 
214} 
22| if( read( fd, (char *) &Opt, sizeof(Opt) ) != sizeof (Opt)? 
23| ferr({ “Internal error: Can’t read options\n" ); 
24| 
25] if( stremp( DEF_SIG, Opt.signature ) != 0 ) 
26] { 
27| memset({ &Opt, 0 , sizeof(Opt)); /* The memset is for 
28 | * debugging.(it shows 
29} * us that the record. 
30} * has been written 
31] correctly./ 
32] 
33| strepy ( Opt.signature, DEF_SIG ); 
34 
a [RRR RIKER ERR IRE RIKER EEK KER ER KER ERR ERE ERE REE EEE / 
36| /* Initialize other fields in the Opt structure here */ 
37 | [RRR RIK RIKI IK IR RRR ERR IIR IER IRR IR RK RR IK IR KIKI | 
38} 
39] Opt.chksum = 0 ; 
40| for( p = (int *) (sOpt), i = sizeof(Opt)/2; --i >= 0; ) 
41] Opt.chksum -= *p++; 
42| 
43| lseek ( fd, OL, SEEK_END }); 
44| 
45| # ifndef DEBUG 
46| if( write( fd, (char *) &Opt, sizeof (Opt) ) 
l= sizeof(Opt) ) 
47| ferr("Internal error: Can’t initialize 
options\n"); 
48| # endif 
49| } 
50] 
51] close( fd ); 





Example 3: Get__opts(/) 
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able. 
As an example, the following 
simple awk program numbers all 


1] put_opts( name ) 


2| char 


SWHRrROWOIDMNS Ww 


onde 


WNHNNNNNNNNNRRRRER 
COOMWIHRAUPWNHRrROWeOWNHAW 


# 
31] 
32 | 
33| # 
34] 
35| # 
36] 
37] 
38| } 


*name; 


/* Update the options buffer (which better exist). 
* If the options buffer doesn’t exist, this 

* subroutine will destroy the end of the file. 

n/ 


int fd, *p, i, checksum ; 
if( (fd = open( name , O_RDWR | O_BINARY )) == -1 ) 
{ 


perror( name ); 
exit (1); 
} 


/* Recompute the checksum */ 


checksum = 0 ; 
for( p = (int *)(&Opt), i = sizeof (Opt) /2; --i >= 0; ) 
checksum -= *ptt; 


if( checksum != Opt.chksum ) 
printf( "Options have changed" ); 


Opt.chksum = checksum; 


ifndef DEBUG 
lseek ( fd, OL - sizeof(Opt), SEEK_END ); 
if( write(fd, (char *) &Opt, sizeof (Opt)) 
l= sizeof(Opt) ) 
ferr( "Can’t do final options update\n" ); 
Oe etnes inne aan No i'm not” ****** 2: 
endif 


close( fd }; 


Example 4: Put__opts() 


BEGIN 


{ pageno = 0; } 


if( (NR % 55) == 0 || pageno == 0 ) 


{ 


} 


if( pageno ) 


# not the first page 
printf (*\£"); 


printf("%s, page %d\n", FILENAME, +t+pageno ); 


printf (" \n\n"); 


printf("%3d: ts\n", NR, $0) 


END { printf£("\£"); } 





Example 5: Listing.awk; an awk program to create 


listings. 
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the lines in the input file and sends 
the result to standard output: 

awk ‘{printf(‘‘%3d: %s/’, NR, $0)}’ 
input 


This one-line program is made more 
useful in the awk program in list- 
ing.awk, Example 5, page 96. When 
executed with: 


awk -f listing.awk input 


a file called input is read and then 
printed with all the lines numbered. 
A header giving the file name and 
page number is printed at the top 
of every page, and a form feed is 
printed at the bottom. Looking at 
the program itself, the BEGIN action 
is done before any input is proc- 
essed. Here it sets pageno to 0. Vari- 
ables are declared implicitly by 
using them. The END statement is 
executed at the end of the input. 
Here it prints a form feed. NR and 
FILENAME are predefined variables 
that hold the current line number 
and input file name. Because there’s 
no specific pattern or other line se- 
lector to the left of the action, it’s 
performed on every line. The # de- 
limits a comment. 

To go to the other extreme, Exam- 
ple 6, page 98 (extracted from the 
book discussed later), holds a ver- 
sion of the Unix make utility, written 
entirely in awk. I've included it here 
primarily so that you can see the 
power of the awk programming lan- 
guage. Getline is a built-in function 
that reads a line of input (in this 
case from makefile). Similarly, sub 
substitutes matches of the regular 
expression given as the left argu- 
ment with the pattern given as the 
right argument. Print, printf, system, 
and close are also built-in functions 
that work as you would expect from 
their names. $1, $2, and so on are 
the fields on the line (fields are 
space- or tab-delimited by default), 
and $0 is the whole line. The ~ 
(tilde) operator is the matches opera- 
tor, so $0 * /~[A—Za—z]/ checks to see 
if the first character on the line is a 
letter. 

To my surprise and delight, awk 
is now available to us masses. The 
AWK Programming Language by 
Alfred Aho, Brian Kernighan, and 








Peter Weinberger is an excellent in- 
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troduction to the language itself, and 
an executable version called MKS 
AWK is available for the IBM PC and 
clones from Mortice Kern Systems 
(43 Bridgeport Rd. E, Waterloo, On- 
tario, Canada N2J 2J4) for $75. 

The book is both lucid and quite 
readable (surprising considering the 
turgid prose in Aho’s other books). 
It starts out with a short tutorial 
introduction to awk. The next chap- 
ter is a complete (but somewhat 
dry) language description, and the 
remainder of the book contains awk 
programs, some quite complex. 
There are chapters on general data 
processing; database management 
and report generation (an awk query 
language is presented); word-proc- 
essing applications (for example, an 
index generator that works with 
troff); language processing (such as 
a graph-generating language that 
takes a graph description as input 
and outputs an actual graph); and 
more (for example, a few fancy sort 
programs, including a heap sort and 
a topological sort program that 
works like the Unix tsort, are pre- 
sented). 

I've only one complaint about the 








book: the actual code is often poorly 
formatted and undercommented, so 
some of the examples are difficult 
to read. The AWK Programming Lan- 
guage is much like Kernighan and 
Ritchie’s The C Programming Lan- 
guage in this respect. Nonetheless, 
as in K & R, the examples are often 
instructive and the time spent deci- 
phering them is well spent. 

MKS AWK is a complete implemen- 
tation of the awk language described 
in Aho's book. It’s quite solid and 
very much like the Unix System V 
(Release 3.1) version (some would 
say too much like Unix—the ubiqui- 
tous syntax error is printed for virtu- 
ally every typo that you make in the 
source file). Four versions of the pro- 
gram are supplied—a large model, 
with and without an 8087, and a 
small model, with and without an 
8087. In addition, versions of the 
Unix date, glob, join, sort, and tr 
programs are provided along with a 
DOS-specific program that let’s you 
change the switch character used 
by COMMAND.COM from a / to some- 
thing more reasonable (thereby let- 
ting you use / in path names). 

Documentation is supplied in a 


UNIX/C WINDOW DEVELOPMENT 
COMPATIBILITY with 
CURSES for MS-DOS and MS-OS/ wR 


THE BETTER PRODUCT. “Aspen Scientific’s 
Curses library is a fine PC version of System V 
Curses. Screen updating was fast and clean... 
has good documentation and is available 
for many compilers...less expensive... 


its greater flexibility makes it an 
attractive package for developers: 
Computer Language, June/87 
“This is a nice product. If you 
need Unix-compatible screen 
output in your programs, 

or if you just want a nice 

clean window-management (/ 
package, I’d recommend it.” Sf 4 
Allen Holub, Dr. Dobb’s {1 
Journal, August/87 





Seer 
»y Limited Time oN 
CALL 1-800-255-5550 
ext. 171 
to ORDER CURSES NOW 
and receive FAST Unix 
Vj compatible forms tool 
: 1 kit with source code 
~~ _ FREE aad 


Sal ica Menu ha as Option 





Complete curses tool kit: $1 19 : 
Source code available for: $289. 


XS 


ASPEN SCIENTIFIC 


P.O. BOX 72 WHEAT RIDGE, 
COLORADO 80034-0072 

For technical questions please call 
(303) 423-8088 
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5.5- X 8.5-inch saddle-stitched book- 
let. It is adequate for describing the 
awk language but is by necessity not 
as complete as Aho’s book. I'd rec- 
ommend getting both the book and 
the program, even though the MKS 
documentation contains everything 
you need to get started. 

In all, awk is a remarkably useful 
tool. It was the one major Unix util- 
ity that I hadn’t seen running under 
DOS, and it’s a welcome addition to 
my toolchest. The Mortice Kern im- 
plementation is very good; I recom- 
mend it highly. 


Books and File Dumps 

Like most people, when it comes to 
work, I have the best of intentions 
but rarely manage to get enough 
accomplished. Consequently, I've an 
ever-growing stack of books to 
review gradually taking over what 
little bare space is available on the 
top of my desk. This month I'll look 
at one of these and hopefully clear 
up the rest of them in upcoming 
months. 


Harbison, Samuel P.; and Steele, Guy 
L., Jr. C: A Reference Manual. 2nd ed. 
Englewood Cliffs, NJ.: Prentice-Hall, 
1987. 


> 


# A make version of AWK. Taken from The AWK Programming Language 


# by Aho, Kernighan, and Weinberger, p. 178. 


bcd 


BEGIN {  . 
while( getline <"makefile™ > 0 } 
if( $0 /*[A-Za-z)/) { 
sub (/:/,"") 


if (+tnames[nm = $1]}] > 1) 
error(nm " is multiply defined”) 


for( i = 2: 1 < NE; i++ } 
slist{nm, ++scnt[nm]] = $i 


} else if ($0 /*\t/) 
emd{nm] = cmd[nm] $0 “\n" 


else if ( NF > 0 } 


error( "illegal line in makefile: " $0 } 


ages () 
if( ARGV[1] in names } 


if ({update(argv[1]}) == 0 } 
print ARGV{1] ™ is up to date” 
} 
else 
error( ARGV[1i] "is not in makefile” } 


} 
function ages( f, n, t } 
{ 


# remember targets 


# remember cmd for current name 


# find initial ages 


Harbison and Steele’s book has 
long been the best reference avail- 
able on the C language—much 
better, in fact, than Appendix A of K 
& R. Prentice-Hall has just published 
a second edition that makes the 
book even more valuable than 
before. The new edition has been 
updated to include the various ANSI 
extensions (at least, the extensions 
as they stood in late 1986). It de- 
scribes the complete C language in 
considerable detail—the book was 
originally intended to be the specifi- 
cation for a compiler project, so it 
goes into the language with the 
detail necessary to actually write a 
compiler—and it also covers all the 
ANSI library functions. Particularly 
valuable are discussions of implemen- 
tation-dependent issues that are 
likely to affect portability. 

There is one unfortunate omis- 
sion from the second edition. The 
first edition had two formal gram- 
mars for C: one was intended to 
show you the language syntax; the 
other was a less readable but more 
practical grammar, such as you 
would submit to YACC. The second 
of these has been left out of the new 
edition. 

Nonetheless, this is a very valu- 
able book that should be in every C 
programmer’s library. I can't recom- 
mend it too highly. 


close("ls -t") 
for( n in names } 


if{ i{n in age) } 
age{]n] = 9999 


} 


# lock for $1: $2 $3 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb's Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
Macintosh, Kaypro). 


Errata: 
Last month’s column examples con- 
tained some errors: 
delete all ‘\sc128\’. 
Example 3, line 14 should read: 
int sam( ), dave(), timer(), idle(), 
maintask( ); 
Example 3, line 35 should read: 
printf(“%ld interrupts, %ld 
blocked\n”, t__numintl ), 
t__numblk( ); 
Example 9, line 7 should read: 
(xhat + = (data - xhat) / + +ki) 


DDJ 
(Listing begins on page 82.) 


Vote for your favorite feature/article. 
Circle Reader Service No. 3. 


# if n has not been created 
# make n really old 


function update(n, changed, i, s } 
{ 


if{ !({n in age }) error{ n “does not exist” } 
if( !(n in names)) return 0 


changed = 0 
visited{n] = 1 


for( i= 1; i <= sent{[t]; i++) { 


- update(s) 


if( visited[{[s = slist[{n,i]] == 0) 


else if( visited[{s] == 1 } 
error(s "and " n “are circularly defined”) 


if( age{s] <= age[n]}} 


changed++ 


} 
visited{n] = 2 


if( changed || scnt{n] — 0 ) 


{ 


printf("%s", cmd[n}) 


system(cnd[n}} 
ages ()} 

age[n] = 0 
return 1 


return 0 


# execute cmd associated with n 
# recompute all ages 
# make n very new 


# execute ls -t (which gives a list if files sorted by time last 
# modified) and pipe the result into getline. That is, the for 
# loop process the output from the ls command, one line at a time 


for{ t = 1; ("ls -t" | getline f) > 0; tt+ ) 
age{[f) =t #all existing files get an age 





Example 6: An awk implementation of make 
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} 


function error(s) { print “error: " s ; exit } 
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C CODE FOR THE PC 


source code, of course 
C Source Code 


Bluestreak Plus Communications (two ports, programmer’s interface, terminal emulation) $400 
CQL Query System (SQL retrievals plus windows) .. . Pe x me fe Sa sh PL asi oe $325 
GraphiC 4.1 (high-resolution, DISSPLA-style scientific plots in color & hardcopy nee Sere $325 
Barcode Generator (specify Code 39 (alphanumeric), Interleaved 2 of 5 (numeric), or UPC) $300 
Greenleaf Data Windows (windows, menus, data entry, interactive form design)... ... . $295 
Vitamin C (MacWindows) ......... Moe eg PEN ae $200 
resident C (TSRify C programs, DOS shared libraries) . $165 
Essential C Utility Library (400 useful C functions) ......... cit > Je path tee $160 
Essential Communications Library (C functions for RS-232-based communication systems) . $160 
Greenleaf Communications Library (interrupt mode, modem control, XON-XOFF) $150 
Greenleaf Functions (296 useful C functions, all DOS services) . . ...... $150 
Turbo G Graphics Library (all popular adapters, hidden line removal) $135 
CBTree (B+tree ISAM driver, multiple variable-length keys)... .....2.. $115 
MultiDOS Plus (DOS-based multitasking, intertask messaging, semaphores) . $115 
PC/IP (CMU/MIT TCP/IP implementation for PCs)... ............ $100 
B-Tree Library & ISAM Driver (file system utilities by Softfocus) . . . . . . $100 
The Profiler (program execution profile tool) ......... oe ee $100 
Entelekon C Function Library (screen, graphics, keyboard, string, printer, etc.) .. $100 
Entelekon Power Windows (menus, overlays, messages, alarms, file handling, BUC) ae au al cg eg tea vs 
QC88 C compiler (ASM output, small model, no longs, floats or bit fields, 80+ function library) $90 
Wendin PCNX or PCVMS Operating System Shell eae ee RE Ete 8 ge eee he ee $95 
Wendin Operating System Construction Kit ......... 20 ee eee Pry $95 
ME (programmer’s editor with C-like macro language by Magma Software) . $75 
WKS Library (C program interface to Lotus 1-2-3 program & files) . . . $65 
Quincy (interactive C interpreter). ....... oc “oS Meee yg $60 
EZ_ASM (assembly language macros bridging C and Ra ig Soo. ss oo RE ae $60 
Multi-User BBS (chat, mail, menus, sysop displays; uses Galacticomm modem cara): :\; $50 
Heap Expander (dynamic memory manager for expanded RRO Eo dese n'a a 9s A a $50 
Make (macros, all languages, built-inrules) ................. $50 
Vector-to-Raster Conversion (stroke letters & Tektronix 4010 codes to bitmaps) $50 
Coder’s Prolog (inference engine for use with C programs) ee eG tye hegre eh a $45 
PC/MPX (light-weight process manager; includes preemption and cooroutine packages) $45 
Biggerstaff’s System Tools (multi-tasking window manager kit) . $40 
CLIPS (rule-based expert system generator, Version SO) Sr 34, $35 
TELE Kernel (Ken Berry’s multi-tasking marker. 63 oa ey $30 
TELE Windows (Ken Berry’s window package)... .... . $30 
Clisp (Lisp interpreter with extensive internals documentation) ....... $30 
Translate Rules to C (YACC-like function generator for rule-based systems) $30 
6-Pack of Editors (six public domain editors for use, study & hacking) . . $30 
ICON (string and list processing language, Version 6 and update)... . $25 
PTree (parse tree management). ........2.2.2.... $25 
LEX (lexical analyzer generator) ee ae oe ae ee eee BP hotdog: oe lemeinns $25 
Bison & PREP (YACC workalike parser generator & attribute grammar preprocessor) . . . $25 
AutoTrace (program tracer and memory trasher' catcher) «> Oe ee $25 
C Compiler Torture Test (checks a C compiler against K & R) . $20 
Benchmark Package (C compiler, PC hardware, and Unix erates «2. yo. eis $20 
T'N3270 (remote login to IBM VM/CMS as a 3270 terminal on a 3274 controller) $20 
PKG (task-to-task protocol package) ic? LS Pe ae Fe gt Sree $20 
A68 (68000 cross-assembler) .........2..., $20 
List-Pac (C functions for lists, stacks, and quenes): 5 ss $20 
XLT Macro Processor (general purpose text translator) hidioas Sp dale Wee ee a $20 
C Tools (exception macros, we, pp, roff, grep, printf, hash, declare, banner, Pascal-to-C) . . $15 
Data 

WordCruncher (text retrieval & document BUIOOIN ROR OID ca ns we 08 yp SR ew hid $275 
DNA Sequences (GenBank 48.0 of 10,913 sequences with fast similarity search program) . . $150 
Protein Sequences (5,415 sequences, 1,302,966 residuals, with similarity search ee $60 
Webster's Second Dictionary (234,932 words) 2°. of ee ee $60 
U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points) . . . $35 
The World Digitized (100,000 longitude/latitude of world country boundaries) pt tatte eae $30 
KST Fonts (13,200 characters in 139 mixed fonts: specify TEX or bitmap format) . $30 
USNO Floppy Almanac (high-precision moon, sun, planet & star positions) $20 
NBS Hershey Fonts (1,377 stroke characters in 14 fonts) dinate syetic a Pe $15 
U.S. Map (15,701 points of state boundaries) re RT ea eerie oh 
The Austin Code Works Voice: (512) 258-0785 
11100 Leafwood Lane BBS: (512) 258-8881 
Austin, Texas 78750-8409 USA acwhnfoQ@uunet.uu.net FidoNet: 1:882/12 
Free surface shipping on prepaid orders MasterCard/VISA 
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COLUMNS 


STRUCTURED PROGRAMMING 


Writing a DOS Critical Error Handler 





n application running under 

DOS gets ugly treatment when a 
hardware error occurs. The alterna- 
tives DOS provides are the infamous 
Ignore (at peril), Retry (and get the 
same error again), and Abort (losing 
the work done so far). To get around 
these nasty consequences, you can 
write a special kind of interrupt serv- 
ice routine called a critical error 
handler. That’s what I'll do here, 
and in the process I'll point out 
some of the features that make the 
new Turbo Pascal, Version 4.0, a real 
treat for serious application develop- 
ers. 

The critical error handler wakes 
up (via interrupt 24h) when DOS 
encounters any of 14 problems asso- 
ciated with disk and character de- 
vices. These problems run_ the 
gamut from an open drive door to 
media failure. The default critical 
error handler built into DOS dis- 
plays a message explaining the prob- 
lem and asks users to select from 
the Abort/Retry/Ignore alternatives. Be- 
cause the default handler sets no 
state switches and returns nothing, 
DOS applications that don’t replace 
it can't make any provision for criti- 
cal errors. The best you can hope 
for is that the error will go away if 
the user selects Retry—fat chance. 

A better solution is to take over 
the vector for interrupt 24h, pointing 
it to your own handler, which re- 
cords what went wrong and sets a 
flag, then returns. Your application 
can check the flag after each disk or 
printer I/O request and, if it finds 








by Kent Porter 


that a critical error occurred, re- 
cover or shut down gracefully; the 
action depends on the nature of the 
error. 

There are two classes of critical 
errors—disk and nondisk. Although 
DOS triggers interrupt 24h for both, 
they require different processing. On 
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entry, bit 7 of register AH contains a 
0 for disk errors and a 1 for nondisk 
problems. Because interpretation of 
the registers differs from that point 
on, entry processing should test this 
bit and branch to the appropriate 
routine. 

Disk errors occur more often than 
nondisk errors do, and there are 
more possibilities. Consequently, 
DOS passes a number of items of 
information, especially in register 
AH. Bit 0 contains 0 if a read failed 
and 1 if a write failed. Bits 1 and 2 
show where the error was detected, 
the patterns being: 


00 DOS work area 

01 File allocation table 
10 ~=Disk directory 

11 Files area 


Register AL indicates the drive on 
which the failure took place, the 
values being 0 for A, 1 for B, and so 
on. The low half of the DI register 
contains an error code (and the 
upper half garbage, so isolate the 
low byte before attempting to inter- 
pret the code). Finally, the BP:SI reg- 
ister pair points to the device driver 
header, although nobody cares in 
handling disk errors. The failure 
codes returned in DI are listed in 
Table 1, page 103. 

The nondisk error class is a catch- 
all for two entirely unrelated kinds 
of problems. One occurs when a 
character 
printer, but it could be a serial port, 
too—signals a malfunction. The 
other occurs when DOS detects a 
discrepancy between the two in- 
memory copies of the file allocation 








device—nominally a 





table (FAT), which governs the man- 
agement of disk space. 

To determine which error is being 
reported, use the address in BP:SI to 
check the attribute word in the 
device driver. It’s at offset 4 from 
BP:SI. If bit 15 is off, the FAT is 
corrupted; if it’s on, you have a prob- 
lem with a character device. In the 
latter case, you can determine which 
device failed by inspecting the string 
at offset 8 from BP:SI. It gives the 
logical device name (LPT1, COM1, 
and so on) of the guilty party. 

The critical error handler built 
into DOS uses this information to 
produce a brief explanation of the 
problem. It then asks the user the 
infamous Abort/Retry/Ignore ques- 
tion and, based on the answer, 
passes one of three codes back to 
DOS in the AL register. A code of 0 
means Ignore (that is, pretend noth- 
ing happened and restore control 
to the running program); 1 means 
Retry the operation; and 2 means 
Abort the program without giving it 
a chance to close files. 

Because the purpose of writing a 
custom error handler is to avoid the 
catastrophic consequences of these 
choices, your handler should record 
information about what went wrong, 
set a Boolean flag (CriticalErrorOc- 
curred) to TRUE, and always return 
0 in register AL. That way DOS will 
restore control to your program, 
which can check the flag with the 
test: 











if CriticalErrorOccurred then ... 


and take appropriate action. 

And what might that action be? 
Well, it depends. If the disk is unfor- 
matted (error code 8), you might 
execute FORMAT as a child process 
using Turbo Pascal 4.0’s EXEC proce- 
dure. For drive not ready (code 2), 
you could tell the user to stick in a 
disk and close the door, then retry. 


Unrecoverable errors call for more 
a eS 
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Discover how powerful—and 
inexpensive—PC symbolic program- 
ming can be with PC Scheme from 
‘Texas Instruments. Whether you’re an 
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beginning, PC Scheme is the complete, 
$95* solution to your software 
development needs. 

PC Scheme combines elegant 
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full Lisp development system. Named 
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—SCOOPS (Scheme Object- 
Oriented Programming System) 
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1-800-527-3500 


* TI Suggested list price 
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(including the Texas Instruments Business-Pro™ computer). 
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Turbo Pascal is a registered trademark of Borland International. 
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STRUCTURED PROGRAMMING 
(continued from page 100) 


drastic action, such as closing all 
files and terminating the program. 
The error handler itself only records 
the bad news; what you do about it 
is up to you. 

There’s a more or less ironclad 
rule among DOS hackers that you 
shouldn't attempt any I/O from 
inside an interrupt handler. This is 
because of the notorious DOS reen- 
trancy problem. An exception is 
made for a critical error handler, 
however; it can perform console I/O 
functions (DOS interrupt 21h, func- 
tions 01h through 0Ch). Turbo Pascal 
and most other high-level languages 
use these very functions to commu- 
nicate with the user, so you can 
safely carry on a console dialog from 
within the handler. 


Examining the Code 

Now let's look at the real live critical 
error handler in Listing One (see 
page 84). It's written as a unit, a new 
feature of Turbo Pascal 4.0 that pro- 
vides for separately compiled, link- 
able modules. 

The only externally visible routine 
in the criterr unit is the InstallCEH 
procedure. It’s called by the using 
program to stuff the address of the 
critical error handler into the vector 
for interrupt 24h, thereby activating 
the handler. It also initializes the 
variables set by the handler and de- 


Means 

Write-protected disk _ 

Invalid drive designator 

Drive not ready: empty or door 
open 

Unknown command: probably 
bad DOS call 

CRC data error: bad disk 
Invalid request structure: 
program error 

Seek error: hardware failure 
Unknown media type: probably 
bad disk 

Sector not found: usually 
unformatted disk 

Write fault 

Read fault 

General failure 





Table 1: Critical error failure codes 
returned in DI 
bet 
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termines the location of the video 
buffer so that the handler can save 
and restore the display image with- 
out permanently corrupting it. 

Incidentally, it’s not necessary to 
restore the vector to the default DOS 
routine when the program ends. 
That’s because DOS automatically 
does this as part of job termination 
processing. For that reason, the unit 
lacks an uninstall procedure. 

The handler itself occupies the 
rest of the unit and is sufficiently 
generalized to serve as a model. This 
handler sets four global variables 
when it gets control: a Boolean flag 
to indicate that an error occurred, 








the error code, the drive if a disk, 
and an action code (the initials of 
Abort, Retry, and Ignore). 

Notice the heading for CEHandler 
in the Implementation section of the 
unit. The $F + switch forces far calls, 
thus guaranteeing that the installa- 
tion procedure will get a full 32-bit 
segment:offset pointer to set the in- 
terrupt vector. The parameters to 
CEHandler are the general registers. 
Because of the Interrupt keyword 
following the heading, the compiler 
saves the named registers on the 
stack at entry, making their contents 
available as local variables. 

The body of the handler begins 


Microsoft. University 
offers the only systems 
training straight from 


the source. 


Microsoft University courses take you to the heart of our 
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Tuition is per person and includes 
all course materials. 


* For a limited time, this course also 
includes the Microsoft Device Driver 
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additional charge. 


**Fees slightly higher in Boston. 
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STRUCTURED PROGRAMMING 
(continued from page 103) 


after the third local subroutine. It 


immediately sets the error flag and 
dissects the AX register into its two 
byte-size components. Next the han- 
dler saves the cursor position and 
copies the screen image onto the 
heap to prevent it from being cor- 
rupted. After determining the error 
class, it dispatches the appropriate 
subhandler to report the problem 
to the user. It then determines what 
the user wants to do about it (Abort/ 
Retry/Ignore) and records it as the 


Ignore, it resets the four reporting 
variables. After restoring the screen 
image and cursor position, it zeros 
the AX register, telling DOS to pay 
no attention, and returns from the 
interrupt. 

The DiskError and NonDiskError 
routines are called from the main 
body, depending on the error class. 
Both call the GiveReason procedure, 
which merely prints a diagnostic mes- 
sage on the screen based on the 
error code passed to it. 

DiskError is straightforward, load- 
ing the error drive global and advis- 
ing the user of the location and 








action code. If the user says to | nature of the problem. The NonDisk- 


If You Have Turbo C You Have 
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Turbo C is a great compiler 
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automatic make. It has virtual memory 
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back to interpreted functions. Function 
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Microsoft, Lattice, Aztec, C86, and Mark 
Williams ($298) and Xenix ($498). 
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Error function is a littke more com- 
plex because it deals with two dis- 
tinct kinds of errors. The branch is 
based on the high-order bit of the 
device attribute. Note the Repeat... 
Until loop that outputs the device 
name; it can be up to eight charac- 
ters long, but if it’s shorter, the 
unused bytes are ASCII 0s. Conse- 
quently, the loop halts on a null or 
after the eighth character, which- 
ever comes first. 

Strung throughout the handler 
are instructions that set the appro- 
priate error indicators so that the 
using program can sense what went 
haywire and decide what corrective 
action to take. 


Testing It Out 

Make sure the door to drive A is 
open when you run the cerrtest pro- 
gram in Listing Two, page 85. The 
program attempts to create a file on 
A. If it can’t, the handler in the 
criterr unit gains control and re- 
ports the problem. The program 
then displays the error globals and 
quits. Because the error handler 
saves the screen before output, then 
restores it when it’s finished, the 
error dialog simply vanishes. 

The Uses statement at the top of 
Listing Two illustrates how units get 
linked with programs in Turbo 
Pascal 4.0. This program uses three 
units, the first two furnished with 
Turbo Pascal and the last the critical 
error handler from Listing One. Any- 
thing in the Interface section of a 
unit is accessible to the using pro- 
gram: constants, types, variables, 
and subroutines. Consequently, al- 
though cerrtest doesn't declare the 
CriticalError variables or define the 
InstallCEH procedure, it has access 
to them via the interface to criterr. 

You might wish to make your own 
critical error handler less user de- 
pendent. In that case, remove all the 
1/O from criterr and simply load the 
reporting variables; your program 
can then decide what to do and 
how much to tell the user. By build- 
ing in a custom critical error han- 
dler, you'll make your software 
much more bulletproof. 


Who Am I? 

Because there’s a new name on this 
column and it’s mine, perhaps I 
should introduce myself. I've been 





Dr. Dobb’s Journal, February 1988 








3 th” MCA Uwe | Wl 


Ss grt 
es 7) | 
> Sa! << Ney “< 


se ; 
ft 


a 
(a 
ToC 


yi 
RT 


pitved 


You’ve got better things to do than repeat the same steps. 
Over. . . and over. . . and over. Up your productivity with 
Greenleaf Software. 

With more than 70 new functions added to our popular libraries, 
Greenleaf is now the most complete and mature C language function 
resource available. It’s no wonder we’ve been rated the best. Winning 
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Library v.2.10 is the fastest communications facility of 
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interrupt-driven asynchronous communications. And, 
only Greenleaf gives you the power to build a 16-port 
communication system. 


Grdér your new Greenleaf library today! See your 
dealer or call 1-800-523-9830. 


Greenleaf Comm Library $185.00 
Greenleaf Functions $185.00 
Greenleaf DataWindows $225.00 
Greenleaf C Sampler $ 94.50 
Digiboard Comm4 $325.00 
Digiboard Comms $535.00 


In stock, shipped next day. 
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DataWindows, the finest C 
programming windows tool 
available, puts windows, transaction 
data entry and menus at your 
fingertips. 

Our new TURBO C versions 
are ready to get you going fast! 
And our new 3-in-1 C Sampler 
for only $94.50 supports Turbo C 
or Quick C with comm, windows, 
menus and more! Our libraries 


support all popular C compilers 
for MS DOS. 
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uses whatever Is available. 
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if present. 
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Managing C Source Code 


No C programmer should be with- 
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you with the support you need to 
make C programming easier. 
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the C language but you can modify 
them to work with other languages 
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Source code in standard K&R C 
is included. You are welcome to use 
it with any compiler (UNIX com- 
patible) and operating system you 
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The documentation contains de- 
scriptions of each program, a listing 
of program options, and a sample 
run. On-line help responds to -? on 
the command line with a list of 
options 
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12 Time Savers 


DIFF - Compare files line by line; 
use CMP to compare byte by byte. 
GREP - Regular expression search. 
FCHART - Trace the flow of control 
between large program modules. 
PP - Format C program files so they 
are easier to read. 

CUTIL - General purpose file filter. 
CCREF- Cross reference variables. 
CBC (curly brace checker) - Check 
for pairing of curly braces, parens, 
quotes, and comments. 

Other utilities include DOCMAKE, 
ASCII, NOCOM, AND PRINT. 
Requires MSDOS and 12K RAM 
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Try C ToolSet ($95) for 30 days — 
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hanging around computer rooms 
since the early 1960s doing various 
software and management jobs, and 
I was one of the micro pioneers 
when I got an IMSAI 8080 back in 
the Dark Ages, which was nine years 
ago. My first book was Computers 
Made Really Simple, published in 
1976 and long out of print. Since 
then, I have written more than a 
dozen more, the most recent being 
Stretching Turbo Pascal (he men- 
tioned with shameless commercial- 
ism). I've written another Pascal 
book as well, and I’m working on 
my second C book at the moment. | 
also write a lot of magazine articles, 
not only about programming but 
also about the application of small 
computers to business problems. 

What I intend to do in this 
column is to present programming 
solutions—this installment being an 
example—as well as to review struc- 
tured programming products and 
discuss issues relevant to software 
development. 

But this isn’t just my column, it’s 
ours. If there's something you'd like 
to see here, drop me a line at DDJ. 
Or you can leave a note for 
KPORTER on MCI. Don't call, 
though, please; I don’t work at the 
editorial offices. No promises, but I'll 
consider any reasonable suggestion. 
Right now I'm one guy in a room by 
himself, trying to guess what The 
Reader (that’s you) wants. I wont 
know until you tell me. Let's make 
this into a forum that’s fun and 
instructive for us both. 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb’s Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
Macintosh, Kaypro). 


DDJ 


(Listings begin on page 84.) 


Vote for your favorite feature/article. 
Circle Reader Service No. 2. 
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XTRIEVE 245 =—-185 
REPORT OPTION 145 99 
BTRIEVE/N 595 455 
XTRIEVE/N 995 455 
REPORT OPTION/N 345 269 
CBTREE 159 = 139 
C-TREE 395 = 3315 
R-TREE 295 239 
C-TREE/R-TREE BUNDLE 650 519 
DBC Ill 250 169 
DBC III PLUS 750 8595 
DB_VISTA OR DB_QUERY 195 159 
SINGLE USER W/SOURCECODE 495 399 
MULTIUSER 495 399 


MULTIUSER W/SOURCE CODE 990 789 
INFORMIX PRODUCTS CALL CALL 
PHACT MANAGER 249 +=219 
XQL NEW 795 = 599 
FORTRAN COMPILERS 
LAHEY FORTRAN 477 CALL 
LAHEY PERSONAL FORTRAN 77 95 89 
MICROSOFT FORTRAN 450 269 
RM/FORTRAN 595 479 
FORTRAN UTILITIES/LIBRARIES 
DIAGRAM’ER OR DOCUMENT’ER 129 115 
DIFF-E-Q 495 445 
FORTRAN ADDENDA 165 139 
GRAFMATIC OR PLOTMATIC 135 119 
MAGUS NUMERICAL ANALYST 295 249 
MATHPAC 495 445 
NO LIMIT 129 109 
SPINDRIFT LIBRARY 149-135 
SSP/PC 350 269 
GRAPHICS 
ADVANTAGE GRAPHICS (C) 250 225 
ESSENTIAL GRAPHICS 250 185 
GSS GRAPHIC DEV. TOOLKIT 495 375 
HALO SPECIAL 300 = 199 
HALO (5 MICROSOFT LANG.) 595 389 
‘METAWINDOW PLUS 275 229 
TURBOWINDOW/C 95 79 
TURBO HALO (FOR TURBO C) 99 79 
LINT 
PC-LINT 139 99 
PRE-C 295 = 155 
MODULA-2 
LOGITECH MODULA-2 

COMPILER PACK 99 79 

DEVELOPMENT SYSTEM 249 199 

TOOLKIT 169 139 

WINDOW PACKAGE 49 39 

ROM PACKAGE AND CROSS 

RUNTIME DEBUGGER 299 239 
REPERTOIRE 


A Division of Hudson Technologies, Inc. 





LIST OURS 
TURBO PASCAL ADD-ONS 


DOS/BIOS & MOUSE TOOLS 75 69 
FLASH-UP 89 79 
METRABYTE DATA ACQ. TOOLS 100 89 
SCREEN SCULPTOR 125 89 
SYSTEM BUILDER 150 =129 

IMPEX 100 89 

REPORT BUILDER 130s «115 
T-DEBUG PLUS 60 49 
TURBO. ASM 99 69 
TURBO ASYNCH PLUS 129 99 
TURBO EXTENDER 85 65 
TURBO HALO 99 79 
TURBO MAGIC 199 179 
TURBO OPTIMIZER 75 65 
TURBO POWER TOOLS PLUS 129 99 
TURBO POWER UTILITIES 95 79 
TURBO PROFESSIONAL 4.0 NEW 99 79 


TURBO WINDOW/PASCAL 95 79 





OPERATING SYSTEMS 
MICROPORT SYSTEM V/AT 549 465 
SCO XENIX SYSTEM V 1295 989 
WENDIN-DOS 99 79 
OTHER MICROPORT,SCO, 

WENDIN PRODUCTS CALL CALL 
PASCAL COMPILERS 
MARSHAL PASCAL 189 155 
MICROSOFT PASCAL 300 185 
PASCAL-2 350 §=6319 
TURBO PASCAL NEW V. 4.0 100 65 


TURBO PASCAL DEV.LIB. NEW 395 259 
BORLAND ADD-ONS CALL CALL 
SCREEN DISPLAY/WINDOWS 
C-SCAPE 279 = 265 
CURSES W/SOURCE CODE 250 169 
GREENLEAF DATA WINDOWS 225 155 
W/SOURCE CODE 395-259 
HI-SCREEN XL 149 119 
JYACC FORMAKER 495 449 
JYACC JAM 750 679 
MICROSOFT WINDOWS 99 65 
MS WINDOWS DEVELOPMENT KIT 500 309 
PANEL PLUS 495 395 
PANEL/QC OR TC SPECIAL 129 89 
QUICKSCREEN 195), | 175 
SCREENSTAR W/SOURCE 198 169 
VITAMIN C 225 149 
VC SCREEN 99 79 
VIEW MANAGER 275 199 
WINDOWS FOR DATA SPECIAL 295 229 





ADDITIONAL PRODUCTS 

ADVANTAGE VCMS 379 = 329 
BASTOC 495 399 
CARBON COPY PLUS 195 159 
DAN BRICKLIN’S DEMO PROGRAM ~~ 75 59 


DB2C 299 CALL 
FLOW CHARTING II 229 =. 205 
MAGIC PC 195, 179 
MKS TOOLKIT 139 115 
NORTON GUIDES 100 65 
PFINISH 395 209 
POLYMAKE 

POLYTRON PVCS CALL CALL 
SOURCE PRINT 95 75 
TREE DIAGRAMMER 77 69 
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COLUMNS 


THE FORTH COLUMN 


Update on Forth in the Industry 


Spey last year has been a busy 
one for Forth. I like to believe 
that the “Forth year” starts and ends 
with FORML (Forth Modification 
Laboratory) at Asilomar in Northern 
California over the Thanksgiving 
weekend. I'll give you a complete 
report of this year’s FORML (87) in 
the next column. Meanwhile, here's 
what’s happened since the last 
FORML (86). I apologize in advance 
for missing anything. 

The Novix 4000 (renumbered to 
4016) continued rising in popularity. 
Both Novix and Software Composers 
released Novix boards for the IBM 
PC. The Novix NB4100 contains the 
NC4016 with B and X ports wired to 
board-mounted connectors and 
128K of program and data memory. 
The Software Composer PC4000 has 
500K of memory on-board and can 
run in parallel with other PC4000 
boards. Each company offers Forth 
development systems as well as C-to- 
Forth translation programs. Novix 
also announced the NB4300 STD- 
bus Novix card. (An STE-bus Novix 
card is available from Forth Systeme, 
W. Germany.) 

Harris Semiconductor announced 
FORCE (Forth-optimized RISC com- 
puting engine), a modified NC4016 
design copied into its macro cell 
library. It expects to offer a FORCE- 
based, real-time control processor 
(RTCP) in the first quarter of 1988. 

Phil Koopman demonstrated his 
WISC (writable instruction set, stack- 
oriented computer) CPU/32, a modu- 
lar hardware Forth engine sold by 


by Martin Tracy 


Mountain View Press. The team from 
Johns Hopkins University demon- 
strated its Forth engine, a 32-bit proc- 
essor with cached stacks and Gbytes 
of address space. The team expects 
it to be generally available sometime 
in 1988. 


Meanwhile, Forth continued to 
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move into newer and more challeng- 
ing hardware environments. Dr. C.H. 
Ting implemented a Novix-based 
micro-code sequencer for NCR's 
GAPP computer. Goddard Space Lab 
(Maryland) implemented Forth on 
its massively parallel processor, a 
two-dimensional array of 128 X 128 
serial processors. FORTH Inc. an- 
nounced a polyFORTH for the Texas 
Instruments TMS32020/C25 digital 
signal processor (DSP). Forth is cur- 
rently the only high-level language 
running directly on this popular 


DSP chip. 
FORTH Inc. also implemented a 
nicely optimized Intel 80386 


polyFORTH running in native mode. 
The company reports that Forth 
benchmarks run faster on this ma- 
chine than they do on the Motorola 
68020. Meanwhile, Laboratory Mi- 
crosystems demonstrated its new UR/ 
FORTH running on the 80286 and 
80386 under Microsoft's OS/2. 

Forth vendors were busy last year 
applying their tools to a variety of 
projects. Miller Microcomputer Serv- 
ices put the finishing touches on 
MMS Forth 2.4, the MS-DOS version 
of Forth used to develop RapidFile, 
Ashton-Tate’s new query-by-exam- 
ple database. The new book Busi- 
ness Programming with RapidFile 
was written by our own Leo Brodie, 
whose improved Starting Forth, 
second edition, was also published 
last year. 

Creative Solutions turned its tal- 
ents inward to develop new hard- 
ware technology. The result was a 
series of boards for Apple’s Macin- 
tosh II NuBus. Three of these Hur- 
dler boards connect the Mac II to 


three other buses: the STD bus, the 
Motorola I/O channel, and the IBM 
PC bus. CSI also announced the Mac 
Il Toolkit, which adds a 68020 as- 
sembler, 6881 support, and color 
graphics as extensions to its popu- 
lar MacFORTH. 

FORTH Inc. spent a busy year work- 
ing with several Fortune 500 compa- 
nies. The company assisted in devel- 
oping a _ package-tracking magic 
wand for a major mailing company 
and renovated the American Airlines 
baggage system, a polyFORTH sys- 
tem that has been in place for the 
past five years. It expanded Bell 
Canada’s data entry system (70—80 
users on one VAX VMS with no loss 
of response) and demonstrated a 
large factory heating ventilation and 
air-conditioning system using the 
ClusterFORTH distributed intelli- 
gence network. 

Advance MicroMotion developed 
an economy Telex and EasyLink com- 
munications package for TTS. Moun- 
tain View Press brought out new 
MVP Forths for the Amiga, the Atari 
600/800/1200, and the PDP-11. New 
Micros announced a hardware and 
software development system for the 
Motorola 68HC11, and Inner Access 
Corp. announced its development 
system for the Zilog SUPERS chip. 

Besides RapidFile, two _ other 
major Forth products appeared. Elec- 
tronic Arts’ STARFLIGHT game took 
several programmer-years of effort 
(see Forth Dimensions, July 1987). 
Frog Peak Music (P.O. Box 9911, 
Oakland, CA 94613) brought out the 
Hierarchical Music Specification Lan- 
guage, which lets you write your 
own synthesizer MIDI driver and 
edit waveforms, durations, and enve- 
lopes as you play. 

Last year also saw the birth of a 
new Forth computer, sort of. The 
Canon Cat (Byte, October 1987) is Jef 
Raskin's first new machine since he 
left Apple, where he headed the origi- 
nal Macintosh team. The Cat has a 
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C-scape 2.0 


¢ Windows, windows, windows 
e Menus, menus, menus 

e Vast help system 

° Create any type of field 

¢ Data entry and validation 

¢ Smart borders 

e Extensive function library 

¢ Swappable device drivers 

e Easy to learn and use 

¢ Easy to maintain and modify 
¢ Unsurpassed flexibility 

e Professional manual 

¢ No royalties; no run-time license 
e Source code included 

¢ Demo package available 





e WYSIWYG screen design tool 

¢ Generates readable C code 

¢ Create menus and data entry 
screens 

¢ Define fields of any type 

e Variables, prompts, and validation 

e Line draw and erase 

¢ Block, move, cut, paste, copy 

¢ Horizontal and vertical scrolling 

¢ Edit Dan Bricklin Demo slides 

e Full color support 

e Fast, easy, and fun to use 

e Includes help 

e Full-feature demo available 




















































































sensitive help system. Scroll lights. Read in screen definitions from disk files. _ 
Automatic vertical and horizontal scrolling. Batteries not included. Double and | 

single line borders. Cross-referenced help system. Save and restore regions of the 
display. Nested menus. Quick C. Create screens from ASCII files. Easy to learn - 
and use. Horizontal and vertical scrolling. Used by consultants and corporations. 
worldwide. Easy to maintain. Professional documentation. Screen designer creates 
readable C code. Portable. Easily modifiable functions. No royalties. Source code included. Turn Dan Bricklin slides into C. Professional support. 
Interface examples for data base management. Validation at keystroke level. Vast integrated and indexed context-sensitive help system. Save and 
restore regions of the display. Now supporting Quick C, Turbo C, Aztec, Lattice, Microsoft, UNIX and others. And that’s not all. Call for demo. 
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FORTH COLUMN 
(continued from page 108) 


9-inch mono display, 3.5-inch drive, 
and a Motorola 68000 CPU. Accord- 
ing to Ezra Shapiro, “If the high- 
lighted text [on the screen] is a com- 
puter program written in either 
Forth or 68000 assembly language, 
the Cat executes it.” 

And of course, the ANSI CBEMA 
X3J14 Forth standardization effort 
began last year. I'll report on the 
second meeting of this committee 
in the next column. Also, there are 
two new Forth electronic bulletin 
boards: the FIG-sponsored GENie 
board (see DDJ, December 1987) and 
the new North Coast Forth Board 
(Minnesota [612] 483-6711). Now 
there are Forth boards north, east, 
and west. South Coast Forth Board 
anyone? 


Forth in AI 
Forth continued to make inroads 
into artificial intelligence. Henry 





/STRING { an n2 —- atn2 n-n2) 
\ n may be negative. 


EVAL {an )} 


ASCIT ( = & 


CTO®" ( ¢ = a@ i} 
\ converts character to string. 


SKIP (ale- a2 12) 
\ returns shorter string from 
\ first position unequal to byte. 


SCAN ( a 1 byte - a2 12) 
\ returns shorter string from 
\ first position equal to byte. 


* (= aj 
\ STATE-smart string literal. 


VAL? (a n-d2,n2i, 9) 
string to number conversion. 
True if dis valid. 


and sets DPL = 0 


PL a ah a er 


and sets DPL = O0< 
VAL (an - ad £} 
\ True if number is valid. 


\ returns -1 if string an<a2n, 


\ 0 if equal, and i if >. 


COMPARE ({ an a2 n2 - -1, O, 1) 
\ returns <1 if a na < a2 m2, \ 0 if equal, and 1 if >. 


MATCH ( a mn az n2? = 27272 0 , Offset -—1) 


\ returns the position of 
\ string a2 n2 in (a nn). 
\ Offset is zero if € an } 


\ is found in first char position. 


\ False with invalid offset 
\ 1f ( an } isn’t in az nz. 


Example 1: String operators 





\ truncates leftmost n chars of string. 


\ evaluates ("text interprets") a string. 


\ returns value of following char. 


Returns d if number contains ",-./:" 


Returns n if no punctuation present 


\ converts string to double number. 





Harris (JPL) presented papers on con- 
ceptual dependency; William Dress 
(Oak Ridge National Lab) presented 
several on neural nets. Two imple- 
mentations of OPS5 and two of 
“fuzzy”’ rule production systems 
were developed last year. Jack Park's 
popular Expert 2 system evolved to 
Expert 5. For a general summary of 
Forth’s recent history in AI, see “The 
Forth Wave in AI” by Robert Tre- 
lease in AI Expert (October 1987). 
Part of Forth’s popularity in AI is 
the ease in which it can be imple- 
mented on experimental computer 
architectures. This makes Forth par- 
ticularly attractive for simulating, con- 
trolling, and testing inference en- 
gines and neural networks. Once 
Forth is ported to a new hardware 
environment, it is possible to imple- 
ment additional languages, such as 
BASIC, LISP, and PROLOG, rapidly 
by writing them in Forth. Panasonic, 
for example, implemented BASIC 
this way on the original HHC (hand- 
held computer). Charles Duff's 
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object-oriented NEON and Actor 
were both written as extensions to 
Forth, too. 

By the way, a tiny Modula-2 has 
just been written in Forth by S. Lohr. 
You can download it from the East 
Coast Forth Board ([703] 442-8695) 
or from the new GENie Forth Board 
as the file TM2.ARC. You will find an 
interesting discussion of language 
bootstrapping techniques in “Em- 
beddings of Languages in Forth” by 
R.D. Dixon in the latest Journal of 
Forth Application and Research, vol. 
4, no. 4, 1987. 

This same issue contains two im- 
portant articles on implementing 
PROLOG in Forth: “A Full PROLOG 
Interpreter Embedded in Forth” by 
Odette and Paloski and “Compiling 
PROLOG to Forth” by Odette. The 
latter article contains careful and 
expert notes on implementing the 
compiler, with complete source 
code. Compiling PROLOG to run on 
Forth hardware gives you an infer- 
ence engine with truly awesome 
speed. Lou Odette reports that a 
“Naive reverse benchmark” runs at 
6,000 LIPS (logical inferences per 
second) on an NC4016 with a (con- 
servative) 4-KHz clock. When the 
next generation of Forth processors 
appears later this year, they should 
run the same benchmark at the 
speed of compiled (Quintus) 
PROLOG on a VAX 11/780. 

Flash! At this year’s annual Forth 
Convention (San Jose, Calif., Novem- 
ber 1987) Silicon Composers un- 
veiled an IBM PC AT board contain- 
ing the FORCE core set from Harris 
Semiconductor. FORCE is imple- 
mented on the board as five sepa- 
rate chips: the Forth-based CPU, a 
hardware multiplier, an interrupt 
controller, a data stack, and a return 
stack. All pertinent signals are bused 
to a prototyping area on the board. 
It has 32K of high-speed RAM, ex- 
pandable to 128K (as soon as high- 
density 35-nsec RAM chips become 
available). 

The development system includes 
an optimizing compiler that reads 
standard ASCII text files. You could 
use this system to prototype and 
test hardware macros before inte- 
grating them into a custom VLSI 
Forth-based RISC machine. The AT/ 
FORCE board is available from Sili- 


con Composers ([415] 322-8763) start- 
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ing mid-December 1987 and retails 
for $4,500. 


Text and Data Files 

In my last column (December 1987), 
I looked at a minimal but useful set 
of string operators, which are sum- 
marized in Example 1, page 110. The 
word MATCH replaces the word 
—MATCH in the last column. Its 
source code is in this month’s list- 
ing (see Listing One, page 86). 
—-MATCH is the name of a 
polyFORTH word that compares 
strings cell by cell and is used pri- 
marily for searching index files. 

The string package was built on 
the Standard prelude (see DDJ, Octo- 
ber 1987) and the DDJ Controlled 
Reference Word Set: 


2” D2* HEX C, 

BL ERASE BLANK .R 

2>R 2R> AGAIN DLITERAL 
S>D WITHIN TRUE 


Definitions for these words are also 
in the listing. 

This month’s topic is accessing 
files from Forth. You may have heard 
that Forth is both a language and 












Turbo Pascal 4.0 is required. Registered 
owners of Turbo Professional by Sunny 
Hill Software may upgrade for $30. 
Include your serial number. 





w* Hire a Pro for 
Your New Turbo 4.0 


f re: on the power of Turbo PROFESSIONAL 4.0, a library of more 
than 300 state-of-the-art routines optimized for Turbo Pascal 4.0. 
You'll have professional quality programs finished faster and easier. 


Turbo PROFESSIONAL 4.0 includes complete source code, 
comprehensive documentation and demo programs that 
are powerful and useful. The routines include: 


Satisfaction Guaranteed or your money back within 30 days. 


For other information call 408-438-8608, 
9 AM to 5 PM PST. Shipping & taxes 
prepaid for US and Canadian customers, 
others please add $6 per item. 


TurboPower Software 3109 Scotts Valley Dr., Suite 122 Scotts Valley, CA 95066 





an operating system. It’s true. Be- 
cause Forth is often the first devel- 
opment system to work in a new 
environment, it needs to manage 
memory, handle interrupts, and 
access mass storage. The essential 
primitives for reading and writing 
mass storage are BLOCK and 
UPDATE. Eventually, when other op- 
erating systems become available, 
Forth may be extended to coexist 
peacefully with them. 

When Forth is itself the operating 
system, it divides mass storage into 
consecutively numbered (1,024-byte) 
blocks. Both source code and data 
are kept in these blocks. There are 
no “text” or “data” files in the 
normal sense. Any source or data 
read by Forth is previously written 
by Forth. 

When Forth runs under an operat- 
ing system, it takes advantage of op- 
erating system calls. Under CP/M, for 
example, any logical sector in a file 
can be read or written directly. Sec- 
tors can be grouped into blocks, and 
so any file can be accessed as a 
sequence of blocks. 

But what if the file is not an inte- 
ger number of blocks long? The file 






Pop-up resident routines 

BCD arithmetic 

Virtual windows and menus 

EMS and extended memory access 
Long strings, large arrays, macros, 
and much more. 








Turbo PROFESSIONAL is only $99. 


Call toll free for credit card orders. 


1-800-538-8157 extension 830 
1-800-672-3470 extension 830 in CA 
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Why puzzle 


when you d. 
have to: 











Micro/Systems Journal has the answers. that M/S/ is famous for 

Whether it’s networking, systems integration, providing . . . in-depth 

programming, or scientific computing tutorials, reviews, hints, the 

questions, M/SJ will lead you out of the maze latest on multitasking, languages 

of microcomputer mayhem. With each issue and operating systems. So stop your 

you'll find comprehensive coverage of all the puzzling . . . subscribe right now and the answers 
technical information that will keep you will be yours. Simply drop the attached card 
up-to-date with the ever-changing microcom- in the mail—that’s all there is to it. 






puter industry. You'll get the hands-on, nuts 
and bolts information, insight, and techniques 
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Yes! | want to subscribe to 


V | MicroSystems 


JOURNAL for the PC Systems Integrator 





and save over 47% off the cover price. 
[ ] 1 Year (12 issues) $29.97 (_] 2 Years (24 issues) $56.97 
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mail; Canada & Mexico add $17 per year for airmail; other countries add $28 per year for airmail. All foreign 
subscriptions must be paid in U.S. funds drawn on a U.S. bank. Please allow 6-8 weeks for delivery. 


A PUBLICATION OF M&T PUBLISHING, INC. 210S 
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| EVEN MORE POWER 





AND FLEXIBILITY 





Users and industry press alike have 
unanimously proclaimed BRIEF as 
the best program editor available 
today. Now, the best gets better, 
with the release of BRIEF 2.0. 

Straight from the box, BRIEF offers 
an exceptional range of features. 
Many users find that BRIEF is the 
only editor they'll ever need, with 
features like real, multi-level Undo, 
flexible windowing and unlimited 
file size. But BRIEF has tremendous 
hidden power in its exclusive macro 
language. With it, you can turn BRIEF 


sion: 


541 Main Street 

Suite 410D 

So. Weymouth, MA 02190 
(617) 337-6963 





Requires an IBM PC or compatible with 

at least 192K RAM. 

BRIEF is a trademark of UnderWare. Inc. 

Solution Systems is a trademark of Solution Systems. 
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into your own custom editor con- 
taining the commands and features 
you desire. It's fast and easy. 

Jerry Pournelle, columnist for BYTE 
magazine summed it all up by saying 
BRIEF is, ‘‘Recommended. If you 
need a general purpose PC program- 
ming editor, look no further.’ His 
point of view has been affirmed by 
rave reviews in C JOURNAL, 
COMPUTER LANGUAGE, DR. 





BRIEF 2.0 


One user stated ‘‘BRIEF is one of 
the few pieces of software that I 
would dare call a masterpiece.’ 
Order BRIEF now and find out why. 
BRIEF 2.0 is just $195. If you already 
own BRIEE call for upgrade 
information. 

TO ORDER CALL: 1-800-821-2492 
(in MA call 617-337-6963) 


_ As always, BRIEF comes with a 


30 day money-back satisfaction 


DOBB'S JOURNAL, DATA BASED guarantee. 
ADVISOR, INFOWORLD AND 
PC MAGAZINE. 
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FORTH COLUMN 
(continued from page 111) 


will only fill part of the last block. 
This leads to the first rule of stan- 
dard file access from Forth: 


1. BLOCK must be able to read the 
entire file. If the last block is partial, 
the contents of BLOCK past the end 
of the file are undefined. Reading a 
partial block is not an error condi- 
tion. 


What about writing to a partial 
block? The UPDATE command tells 
Forth only that some part of a block 
has been written to but not which 
part. This leads to a second rule: 


2. UPDATE forces a partial block to 
be extended to a full block. The file 
length must be adjusted accordingly. 


If you use Forth only to read 
Forth files, you will see no partial 
blocks and neither rule will apply. 
Otherwise, two operating system 
calls are required: 


1. to determine the length of a file 
in some unit easily convertible to a 
double number of bytes 

2. to extend the length of a file by a 
multiple of the same unit 


The easiest way to keep track of 
the length of a file is to call the 
system when the file is first opened 
and to maintain its double-number 
length in a 2VARIABLE (or equiv- 
alent)—for example, CAPACITY. Fur- 
thermore, assume that you can con- 
struct the word EXTEND, which ex- 
tends the file by at least a given 
double number of bytes. Suppose, 
for example, that Forth provides the 
word MORE, which extends a file by 
a given number of blocks: 


MORE Cit Ts 2 a3 

: EXTEND (d ) 

\ extends file d bytes. 
1024 UM/MOD SWAP 
IF 1+ THEN (round up) 
MORE $j; 


In the interests of keeping primi- 
tives primitive, assume that whoever 
calls EXTEND also maintains CAPAC- 
ITY. Some operating systems extend 
pales automatically, so you can use a 
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null definition for EXTEND: 


: EXTEND ( d) COMPILE 2DROP ; 
\ null definition. 
IMMEDIATE 


BLOCK and UPDATE give you 
direct access to a file. Data stream 
and text files, however, use sequen- 
tial access, reading and writing the 
next group of characters or bytes. 
This implies that you should main- 
tain a current (double-number) byte 
position for the file, which can be 
kept in a 2VARIABLE (or equivalent) 
—call it POSITION. POSITION is 
initialized to 0 when the file is first 
opened. The words GETDATA and 
PUTDATA can now be defined to 
read or write the next n bytes of a 
file to or from a memory location: 


: GETDATA (an-—-n2)...; 
\ reads n bytes of data from file 
\ into address, n < 64K. Returns 
\ n2 bytes not read, ie beyond 
\ end of file. 
:PUTDATA (an) .i3'5 
\ writes n bytes of data to file 
\ from address, n < 64K. 


High-level definitions of these words 
are in Listing One. If possible, you 
should implement them as system 
calls instead. 

Given POSITION, CAPACITY, GET- 
DATA, and PUTDATA, you can im- 
mediately implement GETLINE and 
PUTLINE to access text files. A text 
file is simply a sequence of text 
lines, which are in turn a sequence 
of characters terminated by an end- 
of-line condition or an end-of-file 
condition. These conditions are typi- 
cally implemented as special charac- 
ters. Each line may be terminated 
by an optional line-feed character: 


-:GETLINE (an-an2f)....; 


\ reads n bytes of text from file 

\ into address, n < 64K. n2 bytes 
\ are actually read. True if end- 

\ of-line terminates line. 


> PUTIANE. C4 AD <%5 
\ writes n bytes of data to file 
\ from address, n < 64K. 


GETLINE is based on GETTEXT, 
which is based on GETDATA. The 
end-of-line flag is needed because 
either end-of-line or end-of file can 











return a zero-length string. 

Note that all the words I've just 
described can ultimately be built 
from BLOCK and UPDATE, provided 
that the given rules and assump- 
tions are valid. Nothing has been 
said about file selection, which 
changes greatly from Forth to Forth. 
Selecting the proper file before ac- 
cessing it is up to you. Most operat- 
ing-system-oriented Forths allow 
you to select one of at least two files, 
typically one for input only and one 
for output or modify. When you 
change files, you must update or 
switch CAPACITY and POSITION ac- 
cordingly. 

Now that you can access text files, 
you can do some truly wonderful 
things: 


: TYPE-FILE 

\ reads and prints a file. 
BEGIN PAD 80 GETLINE 
WHILE CR TYPE 
REPEAT 2DROP ; 


It really is that easy. In the listing, 
I have included examples for copy- 
ing text files and for converting 
blocks to text and back again. One 
final example shows you how to 
interpret text files, which you can 
create using Borland’s SideKick or 
some other handy text editor: 


>: EVAL-FILE 

\ reads and interprets a file. 
BEGIN PAD 80 GETLINE 
WHILE EVAL 
REPEAT 2DROP ; 


Availability 

All the source code for articles in 
this issue is available on a single 
disk. To order, send $14.95 to Dr. 
Dobb’s Journal, 501 Galveston Dr., 
Redwood City, CA 94063, or call (415) 
366-3600, ext. 216. Please specify the 
issue number and format (MS-DOS, 
Macintosh, Kaypro). 


DDJ 
(Listing begins on page 86.) 
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Circle Reader Service No. 1. 
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DEBUGGING SWAT TEAM — 


Order Eco-C88 Rel. 4.0 New Modeling Compiler go 
and get C-more at no extra charge! , ae 


Seek and Correct 


You already know that fast compilation does not mean fast program development. Backing 

up for bogus error messages and removing the bugs takes time. Eco-C88’s “Seek and Correct” 
three - way error checking finds even the most elusive bugs, clearing the path for swift program 
development. 


Double Barrel Error Checking 


Eco-C88 nails cold and tells you about the error in plain 
English. And there’s no avalanche of false error messages, either. Other 
compilers can generate up to four times the number of error messages 
actually present; they leave it up to you to guess which ones are 

real. You'll be more productive with Eco-C88 because there is no 
guess work. 


Eco-C88 provides ten levels of checking. You can 
select from almost no checking to the fussiest you’ve ever seen. 
Eco-C88's “picky flag” finds subtle errors that slip by 

other compilers. 


Eco-C88 also features: 


All data types, plus ANSI Enhancements 
@ Robust library, including many new ANSI 
functions 

CED editor with online function help, split 
windows, compile-edit-link capability 

© New, expanded manual with sample pro- 
grams for the library functions 


C-more Source Code 
Debugger 


Finally, if a really nasty bug persists, 

put C-more, our source code debug- 

ger, to work. With C-more you can 

watch your program as it executes, 
single-step it, set simple or conditional 
breakpoints, test complex expressions, 

use variables as indexes into other vari- 

ables, initialize and trace variables, examine 
CPU registers, display results with print f()- 
type options and much more. C-more can help 
you track down bugs in minutes rather than days. 





The price for Eco-C88 is $99.95. And, fora 
limited time, we’ll give you our C-more debugger 
at no extra charge. 


Ecosoft Inc. 
6413 N. College Ave. 
Indianapolis, IN 46220 


(317) 255-6476 (Tech Info) 
(800) 952-0472 (Orders) 47 
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REVIEWS 


EXAMINING ROOM 


The 


Norton Guides 





Target: 
PC or PS/2 and compatibles 
Requires: 


DOS 2.0 or later. Hard disk recommended 


Pricing: 


$50 for the program, $50 for each language guide 


Vendor: 


Peter Norton Computing Inc. 2210 Wilshire Blvd, Santa Monica 90403 


(213) 453-2361 





ome years ago, after watching 

me work, my daughter an- 
nounced to her playmates that a 
programmer is someone who sits in 
front of a computer looking things 
up in books. It seemed funny at the 
time, but the more I do it, the more 
I realize she was right. For the unini- 
tiated, here's how to program: open 
to the index of manual A, turn to 
half a dozen references before you 
find what you need, make two key- 
strokes, then open manual B and 
repeat the process. While compiler- 
makers toil mightily to shave milli- 
seconds off compile time, we plod 
through weighty tomes checking 
error codes, parameter-passing 
conventions, syntax diagrams and 
all the rest. Simply put, the greatest 
obstacle to programmer productiv- 
ity is the everlasting need to look 
things up. 

Well, Peter Norton has done some- 
thing about it with his Norton's 
Guides. The glib hype says it’s a 
product for those who hate manual 
labor. A more specific description is 
that it’s on-line, language-specific 
help for serious programmers. Yes, 
it’s another memory-stealing 37K Ter- 
minate-and-Stay-Resident program, 
but think how much desk space it 
clears up. 

Any time youre in text mode— 
editing a program, using a debugger, 
whatever—Shift-F1 wakes up the 
Norton Guides by giving you a half- 
screen pop-up containing a menu 
bar. Thoughtfully, the pop-up ap- 
pears in the half away from the 
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cursor, so that it doesn't obscure 
the code you're working on. You can 
toggle to full-screen with F9, and 
make the pop-up go away with Esc 
or F10. 

And what do you get with the 
pop-up? Initially, a list of every in- 
struction in the language on a scrol- 
lable panel. You can also do a key- 
word search that takes you straight 
to the instruction you want. Posi- 
tioning the highlight over an instruc- 
tion, you press Enter and shazam! 
you get a detailed description of its 
purpose and syntax, often with a 
code example. There are also cross- 
references to related statements and 


File View Search Run Watch 


244: 
245: 
246: 

| 247: 
248: 
249: 
258: 
251; 
252: 


_  . ax, ax 
ee 
firstpg: call pager 


nextkey: @GetKey @,8,8 


nextkeyZ: cmp al,@ 
fe extended 





i=] 
ba | 


NS NON a NN 


Options 
show. ASM 


Note how breakpoint lines are highlighted on the screen. 


We can execute through code one line at a time with either 

the Trace or the Step command. The difference is that Trace 
traces into a procedure and Step steps over the procedure. 

For example, let’s trace into the call to ‘pager’ with the 

Trace command. The command letter is T.. . 


topics, to which you can jump by 
pointing to a pick list entry and 
pressing Enter. 

Additionally, the Guides furnish 
information about specific features 
of a given language implementation 
(the library functions of Turbo C 
and Microsoft C, for example, as 
well as data types, reserved words, 
etc.). Another menu selection called 
Tables leads to all those little details 
that consume so much look-up time 
in manuals: the ASCII values of line- 
drawing and graphics characters, 
color codes, etc. In short, the Norton 
Guides furnish, with a few key- 
strokes, access to most of the infor- 
mation programmers need while in 
a fever of creativity. 

The foundation of the Guides is a 
$50 program that makes it work. 
Then you'll also need one or more 
of the language databases, each 
priced at $50. The entry price, then, 
is $100, plus $50 per language there- 
after. If you have more than one 
database, the Options menu lets you 
switch among them with a couple 


Language Calls Help | F8=Trace F5=Go 


z 


= 9008 
8808 
9088 
2888 
@22E 
0008 
@8A7 
21F4 
6857 
67FA 
6857 
t 688A 
B1CA 


NV UP 
EI PL 
ZR NA 
PE NC 


> Start at 6 


; Get a key 
; is it a null? 
; Yes? Must be extend! 


ee ea aa WR | 


Press any key 





Figure 1: The Norton Guides add on-line help to a number of compilers, 


including Turbo C. 
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F = = 1. We're fast 


SHOULD BE A JAINUS/ADA COMPILER 
(Besides the Price!) 





6. We offer embedded systems capability, 
like rommable, reentrant code and licensing 


Compilation and development speed mean a lot 
of our source code. 


when you're working on a large program; every 


Tt 


minute you have to wait is time and money wasted. Janus/Ada is designed to make your embedded 
A Janus/Ada compiler has an average compila- processing easy ... with features especially 
tion soeed of 400 lines per minute with a 6 MHZ created for that environment. Our code is rom- 
8086; over 500 lines per minute with an 80186; mable, allowing you to “burn in” the applications 
4100+ lines per minute on an 8 MHZ 80286, and you create. We make our source code available, in 
nearly 1900 lines per minute on PC Limited's 386. our Systems Package (“S” Pak), so you dont have to 
guess at the answer. If you would prefer fo have us 
We work on any XXX86 machine. design and implement your code, we'll be more 
Not everybody can afford the newest technology than happy to accommodate. 


and some of us cant afford the name brands... 
but with Janus/Ada, that doesnt matter. It doesn't 
need protected mode, 8087's, or PC-DOS. As long 
as you have an Intel 80X86 chip at the heart of your 


Superior error handling. 


Nothing is more frustrating than an error in coding 
.., except a bad error message which does 





computer and some way to run or emulate MS-DOS nothing except confuse you. Our error messages 
2.1 or higher, you can use Janus/Ada. tell you vital information, such as line location, 

cause of error and a full walkback including sub- 
Our product has been in use for over six years. program names. If you do a lot of develooment, or 
We released our first compiler in 1981 and got our you just appreciate being fully informed, our error 
first review in 1982. The products we sell have had messages are sure fo please! 


the scrutiny of customers and reviewers for over six 
years, changing to meet the increased sophistica- 
tion of the technology and the user. Our customers 
come from every segment of the computing com- 
munity; the government, Fortune 500, and acade- 
mia. Users like yourself are able to benefit from the 
wide range of uses we respond to every day, as 
well as the built-in network of people working with 
Ada just like you. 


Support that won't let you down. 

Superior support services, such as the Janus/Ada 
bulletin board, the Janus/Ada BIX conference, a 
quarterly newsletter, as well as customized support 
Services. 


Our compiler was developed on a micro, 
for a micro, in Ada. 


We have “bootstrapped” our compiler, version by 





No copy protection. version, so that we know it really works! Our com- 
Our products come to you free of any form of copy piler was developed on multiple XXX86 machines, 
protection and with a warranty insuring media from different manufacturers, so that it would be a 
replacement for defective media. We know you true microcomputer compiler. Our products are 
dont need the hassle of locking devices and other developed in Ada, demonstrating our commitment 
protective devices. We know you want to use Janus/ fo the language and the capabilities it can bring 
Ada on your hard disk and network, and we make To you. 


it easy to install, easy fo maintain, and easy fo use. 


F = = 10. Self paced, low cost educational tutorials. 
Application programs written in Ada fas The Janus/Ada Extended Tutorial offers a program- 
for as low as $12.00. amea nae mer’s perspective on learning Ada. This tutorial was 
We offer IBM graphic routines, window handlers, written expressly for novices in the Ada language, 
scientific libraries and many other application pro- by a programmer, and includes a complete set of 
grams written in Ada. These programs come with disk based quizzes to compliment the 150 page 
complete source code and documentation and tutorial. You can determine how quickly you pace 
are user tested. yourself, and you won't believe you did it for $99.95, 


JANUS/ADA PASSED VALIDATION 12/44/87 .. . AND IS STILL ONLY $99 





CP M.CP M-86. CCP M-86 are tra 
“ADA is a trade k 
MS-DOS is a tradem 


e trademarks of Digital Research, Inc 
mark of the U.S. Department of Defense 
ark of Microsoft 








= Copyright 1987 RR Software 
= =e as cae INC. specialists in state of the art programming 

: P.O. Box 1512 Madison, Wisconsin 53701 cicdk ass 45 A REAR (ECARD 
en ween (008) 244-6436 TELEX 4998168 1-800-722-3248 : 


Unmatched. 


If you want 
unmatched a 
performance and 
portability, we | 
have it.The | 
hottest file 
handlerand 
report generato 
on the market. 


The c-tree file handler offers 
unmatched file accessing speed. The 
r-tree report generator makes pro- 
ducing reports a snap. Both pack- 
ages offer unmatched portability. 
Thousands of programmers are 
using these packages in over 50 sys- 
tem environments: DOS, UNIX, 
XENIX, OS/2, MACINTOSH, VAX, 
TOWER and 


More for your money e complete 
C-source code e single and multiuser 
capability e no royalties e unlimited 
free technical support e port to all 
machines for one price. 


c-tree features e fixed and variable 

length data records e record locking 

e variable length keys and key 

compression e overcomes OS file 
and more. 


r-tree features e no printer spacing 
charts e change reports without 
recoding e unlimited control breaks, 
accumulators and virtual field calcu- 
lations e powerful search, select 
and sort capabilities over multiple 
saves days of coding. 


FairCom’s unmatched products will 
work for you. Order c-tree today for 
$395, r-tree for $295. When ordered 
together, r-tree is only $255. For 
VISA, MasterCard and C.O.D. orders 
call (314) 445-6833. For c-tree 
benchmark comparisons, write us at 
4006 West Broadway, Columbia, 
MO 65203. 
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4006 W. Broadway Columbia, MO 65203 


118 UNIX is trademark of AT6T, MACINTOSH is trademark licensed to Apple Computer Company, 
VAX is trademark of DEC, TOWER is trademark of NCR, XENIX is trademark of Microsoft 





EXAMINING ROOM 
(continued from page 116) 


of keystrokes. 

As of this writing, Guides are avail- 
able for BASICA, QuickBASIC, Turbo 
BASIC, Turbo Pascal, Turbo C, Micro- 
soft C, and MASM. A spokeswoman 
for the company says more are in 
the works and should be out by the 
time you read this: the OS/2 kernel 
and Microsoft Windows are two that 
she'd 'fess up to. 

For serious programmers, I recom- 
mend a set of two databases: MASM 
and the high-level language you nor- 
mally use. That’s because the Assem- 
bler Guide contains a wealth of DOS- 
related information not found in the 
others: error codes, interrupts, file 
attributes, and descriptions of the 
PSP and FCB structures, among 
others. If you want to reach deep 
into the machine from C or Pascal, 
you need this stuff. 

There’s a mistake in the Tables, 
which are common to all incarna- 
tions of the Guides. It says the 
screen attribute byte is given by 
256 * background + foreground; re- 
place 256 with 16. I reported it to 
the vendor, so it should be fixed in 
future releases. The Turbo C sample 
program for vprintf() closes a non- 
existent stream. Other than that, my 
only complaint is that the tutorials 
are cloyingly cutesy. These minor 
points are enormously outweighed 
by the convenience of having a com- 
prehensive language reference in- 
stantly available at one’s fingertips. 

In addition to the basic TSR, the 
program package includes tools for 
rolling your own guides. Norton 
calls them a compiler and linker, 
but don't be misled; they constitute 
a text formatter governed by a half- 
dozen commands embedded in the 
ASCII files. These “bang commands” 
associate text lines with menus, set 
up cross-references, establish link- 
ages among text files, and so on. 
Once you've linked your files, they 
become a database available through 
the Guides’ Options menu. It takes 
about 15 minutes to master the 
whole process. 

This opens the way to tremen- 
dous possibilities for application de- 
velopers. Instead of laboriously con- 
structing help screens and all the 
code required to manage them, you 
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Some of the world’s biggest 
problems are being solved with 
a touch of Smalitalk. 


The French Ministry i" 
of Porcion Affairs i Abroad and involved 


responsible for keeping in foreign affairs. 

track of every French 

citizen living abroad and every foreigner living in France. Each day, 
they process thousands of requests for documents or information, 
each one of which takes at least fifteen minutes. Arthur Andersen, 
the world’s largest accounting firm, has developed a natural lan- 
guage processing application with Smalltalk/V that enables clerks 
without computer training to extract the necessary data much faster. 
Thanks to Smalltalk and system developers Bart Schutle and Pascal 
Wattiaux, what once took fifteen minutes now takes 30 seconds. 
Vive la Smalltalk! 

















On the ground 
floor of high-tech 
environmental 


control. Cimaie, energy, fire and security are all 
critical aspects of environmental control in large office buildings. 
The challenge for Johnson Controls, a leader in this industry, is to 
provide a control system that ts both technologically advanced and simple 
to operate. Using Smalltalk/ V, Research Scientists Gene Korienek and Tom 
Wrensch have developed a prototype that integrates all environmental functions 
into a real-time control system using sophisticated color graphics on a PC. This 
enables the building engineer to immediately spot and correct problems by simply 
clicking a mouse. And provides building owners and tenants with a better climate 











for business. 

The world is made of objects. So a short amount of time. Perfect for From 640K to 16 MB capacity for 25 
naturally, the world is turning to Object- = programmers who are looking for a times the memory. And designed it 
Oriented Programming (OOPS). And fast, efficient prototyping environment. __ to run on the next generation OS/2 
the fastest, easiest OOPS language And anyone who wants to quickly and _ operating system as well as DOS. 
ae Ss, is Smalltalk/ V. easily learn OOPS. Get Smalltalk for a small price 

it you program by defin- F ; : 
ing objects, their inter-relationships ane oe ane Smalltalk/V sells for just $99.95. 
and their behavior. Objects Ss sah lItalk/V286 Smalltalk/V286 is $199.95. The follow- 
can represent both i mallitalk/ 7 ing optional applications packs are 
fexteuorid entities she? Our newest version of available for $49.95 each: Communi- 


— people, places, Smalltalk offers faster cations; EGA/VGA Color; Goodies 





things—as and more powerful #1;Goodies #2, Carleton Jools and 
well as useful OOPS capabilities Goodies #3, Carleton Projects. 
abstractions We've gone from And everything comes with a 
such as 16 to 32-bit 60-day, money-back guarantee. 
stacks, architecture. So visit your nearest dealer. Or call 
sets and toll-free, 800-922-8255 and order 
rectangles. direct with MasterCard or Visa. Or 
Smalltalk/V Teaching write to Digitalk, Inc., 9841 Airport 
provides every- students to Blvd., Los Angeles, CA 90045. 
thing you need = think economically. And let us help you put 

to solve problems With OOPS and Smalltalk, even non- Smalltalk into action. 






big and small, _ : programmers can create exciting applications. 
including a com- Economics Professor Arnold Katz of the University of Pittsburgh developed Economics 
prehensive tutorial PC Discovery World, an intelligent tutoring system for his beginning microeconomics 
students. Using a mouse to access a series of windows and manipulate data, a 

to get you started. student can call up a set of markets and commodities for an imaginary community. 
Wh d By changing the scenario, the student can not only study a variety of market 

o needs behaviors, but also test the validity of his or her own reasoning. A process that 
Smalltalk? provides a lot of food for thought. 


Because Smalltalk models the way 


people really think, it is perfect for 
scientists, engineers and professionals 
who have to solve tough problems in 


Smalltalk/V requires DOS and 512K RAM on IBM PC/AT/PS or compat- 
ibles and a CGA, MCGA, EGA, VGA, Toshiba T3100, Hercules, or AT&T 
6300 graphic controller. A Microsoft or compatible mouse is recommended. 
Not copy protected. Smalltalk/V286 requires a 286 or 386, DOS or OS/2 
and iMB of memory and one of the graphic controllers list above. 
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Maaic PC: 
A REVOLUTION IN POWER, PRICE 
& PROGRAMMING SPEED 


ou know how database applications are created — by hacking out 
line after line of time-consuming code. Most DBMS’ and 4GL’s give 


you some programming power. But when it comes to serious applica- For a limited time, you can get Magic PC for only $199. And even at this low price, Magic P® 

tions, they keep you bolted to your seat writing mountains of tedious is risk-free. If you're not completely satisfied, simply return it within 30 days and we'll buy it 

code. And rewriting it all over again with every design change. back (ess $19.95 restocking fee). And if you'd like a preview, Magic PC’s Tutorial Demo is 
Imagine how much faster you'd be if you could replace the painful available for just $19.95. 

coding phase with an innovative visual technology which takes only a But you'd better hurry - Magic PC’s special $199 price won’t last long! 


fraction of the time: Introducing Magic PC—the revolutionary Visual 
Database Language from Aker Corporation: 





With Magic PC’s visual design language you quickly describe your 
programs in non-procedural Execution Tables. They contain compact 
programming operations which are executed by Magic PC’s runtime 
engine. You fill-in the tables using a visual interface driven by windows 
and point-and-shoot menus. One table with 50 operations eliminates 
writing more than 500 traditional lines of code. Yet with Magic PC you 
don’t sacrifice any power or flexibility. 


Pop-up Zoom Windows run multiple programs per screen — with 
point-and-shoot data transfer between windows! 


To unleash your DBMS design power, order your $199 copy of 
Magic PC right now by calling toll-free or returning the coupon below. 


ORDER NOW: CALL 





In CA (714) 250-1718 


“Magic PC's data base engine delivers powerful applications in a 
fraction of the time. . . there is truly no competitive product.” 
Victor Wright - PC Tech Journal 


With a powerful set of high-level non-procedural operations you 
program at only a fraction of the time. 


With Magic PC, you can generate robust DBMS applications includ- 
ing screens, windows, menus, reports, forms, import/export, and much 
more! Plus, Magic PC has one of the friendliest user interfaces you’ve 
ever seen. Using Magic PC you can look-up and transfer data through 
a powerful Zoom Window system. Magic PC even lets you perform 
command-free queries. 


Also recommended by: PC Magazine, PC World, PC Week, Computer 
Language, Data Base Advisor, and many other publications worldwide. 


MAGIC PC 


e Database Language 


AKER 







Magic PC incorporates Btrieve, the high-performance file manager 
from SoftCraft. This gives you exceptional access speed, extended data 
dictionary capabilities, and automatic file recovery! 





Yes! | want 
With Magic PC you can modify your application design ‘“‘on the fly’ to generate powerful 
without any manual maintenance. Magic PC automatically updates applications much faster! a 


your programs and data files on-line! This also makes Magic PC an 


C) Rush me my copy of Magic PC at the special promotional price 
ideal tool for prototyping complete applications in hours instead of days. ete 5 Mea special p P 


of $199 (add $10 P&H, and tax in CA Intemational orders add 
$30). I understand I can retum Magic PC for a refund within 30 
days, if I’m not completely satisfied.” 











| 
l 
: 
l 
> I 

Magic PC comes complete with LAN features. Develop multi- user he? ag : 
applications for your LAN with Magic’s file and record- locking oe Fe : TAs — ou ‘ ve f nah atid 2s srrrdeisrrre ta oa? 3 
security levels. “eS ge we Oh — ‘ ee ee. | 

* Bn a a aS SS Seen Ue ae BE Ror aee Pere SPT er wack 
“*, Se A, ° Ff 
EF BS ae. a SE ee Nee tt Oe eR LN EDS MaDe Ste ine See a 

Distribute your applications and protect your design with Magic PC’s ‘ or ji . Senet Addie (hn BOR) oo | 

low cost runtime engine. 4--~ ae ope vee <j : ORY ch sicacsieintaegenns SUE Zip ; 
Se. “Wy AE, : f 1 UD Check enclosed Charge to my: C) Sagem Cl (ons] Co gee 
cm ae & | — 

Best of all, Magic PC is an unbeatable bargain. For a limited ee: Yo : : ps Win NAY ioe 8ass os Sarde es ee a : 
time, Magic PC’s price has been reduced to only $199! Yes, this is .— ee a ; Acct. Name Ep Date 
the same Magic PC that normally lists for $695! And Magic PC La — f , _ Signature | $ 
eliminates the need for a separate DBMS, compiler, or applica- = foe | |_Retum to: __Aker Corp., 18007 Skypark Cir B2, vine, CA 92714 Sa 


tion generator. It comes complete with all the tools you need 


System requirements: IBM PC, XT, AT, PS/2 or 100% compatible with 512K RAM, hard disk and DOS 
to develop your own database applications instantly. 


2.0 or later. 5'4” format, not copy protected. Dealer pricing available * Reum policy valid in US only. 
Aker, Magic PC, The Visual Database Language are trademarks of Aker Corporation. All other 
trademarks acknowledged © Copyright 1987, Aker Corp. 
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can write a Guides database and 
bundle it with your software. Norton 
Computing says they're willing to 
license distribution rights to the un- 
derlying TSR program. 

The Norton Guides don't com- 
pletely eliminate the need for manu- 
als and reference books, but they 
reduce clutter around the keyboard. 
They also let you write code a whole 
bunch faster, which is good news. 
This product represents a quantum 
jump in programmer productivity. 

by Kent Porter 


Soit-Scope 
Source-Level 
Debugger 





Target: 

PC/XT and compatibles 

Required: 

DOS 2.0 or later, hard disk, 256K. 
Compiler/linker generating Intel-type 
symbols 

Price: 

(DOS version only, others available) 
Debugger is $500 One-year update/ 
support is $100 

Vendor: 

Concurrent Sciences Inc. P.O. Box 
9666 Moscow, ID 83843; 

(208) 882-0445 





hrow out the quiche, put the 

dog in the back of the pickup, 
and crack open a beer; Soft-Scope is 
a real man’s debugger. No wimpy 
windows, no frilly function keys, no 
cuddly colors. No Sir, this is purely 
a command-driven program on a 
monochrome screen that keeps on 
scrollin’. It might be argued that real 
men don’t use symbolic debuggers 
at all, but those who do will appreci- 
ate the full features and solid feel 
that underlie Soft-Scope's rugged ex- 
terior. 

Soft-Scope reminds us of the for- 
gotten fact that software doesn't 
have to be cute to be useful. What it 
lacks in sex appeal, this debugger 
makes up for in functionality. It moni- 
tors and reports program execution 
at the source level in any of Pascal, 
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C, FORTRAN, Assembler, and even 
PLM and JOVIAL. You can set break- 
points on source lines and refer to 
variables by name when checking or 
assigning values. If you want to see 
what the compiler generated from a 
source line, you can view the result- 
ing machine language as assembly 
code. 

The point of reference when work- 
ing with Soft-Scope is the source 
line number, which it gets from the 
requisite .LST file. Like a BASIC inter- 
preter, it tracks its position in the 
source file via line numbers, and 
lists ranges of lines on command. It 
also associates a line number with a 
subroutine name, so that you can 
refer either by line or by name to 
entry points for setting breaks and 
the like. A command lets you find 
out the range of lines for a given 
routine. This is useful for setting a 
watchpoint within that range only, 
using the commands “RANGE 100 
120” and “GO TIL X = 5.” 

The single-step trace mode works 
by default at the source line level. 


NOW! 
SHIPPING 








Utilities for Advance users 


You get into single-step with the S 
command, then keep punching the 
space bar to execute successive 
lines. Soft-Scope displays each line 
as it executes it. If you get tired of 
this, you can hit Enter instead of the 
space bar, then specify a speed from 
0 (slowest) to 9 (fastest), and the 
debugger runs in continuous mode, 
displaying each line as it runs. The 
Q key (or alternatively Esc) stops it 
so that you can examine variables. 
You can also disassemble the source 
line and single-step at machine- 
code level, which is a nice feature 
for uncovering those bizarre glitches 
that sometimes crop up in programs 
that tickle the deep innards of the 
machine. 

Soft-Scope has the particularly at- 
tractive ability to display the nesting 
of calls by name. A program crashes 
in some subroutine and you wonder 
how on earth it got there; this tells 
you who called whom, back up to 
the main program level. You can 
also list the stack itself to any level 
from the top down; e.g. “20 STACK” 


FOR 
OS/2 


OS/2 or DOS 


YES! 
YES! 
YES! 
YES! 
YES! 


NOW, no waiting, the same program runs on OS/2 (PROTECTED and REAL 
modes) and on DOS 2.X or 3.X without modification 


Help you port the DOS applications onto OS/2. Great for C, MASM, PASCAL, 
DBIIl+, BASIC programs and others. 

Includes the programmer's favorite screen editor—VI COMPATIBLE. More than 
1,000,000 UNIX programmers now use V 

No need to do CROSS development on UNIX any more; with OS/2 and ADOS + 

you can develop and test programs on the same Machine. 

Many smart features are added, making ADOS + becomes the most powerful 
utilities for OS/2. Yet it’s still compatible with UNIX tools. 


@ EDITOR: ex, edit, view, ctags and vi: New }ADOS + ENCHANCED FEATURES 


features includes 25/43/50 lines, .bak, 
color, etc. 

@ FILE MANAGER: cp, head, Is, mv, 
pwd, rm, sum, touch, version, which 
and whereis. 

@ TEXT HANDLER: cat, cmp, diff, grep, 
od, strings, tail, and we. 


@ MULTI-TASKk: kill, log, nice, tee and utime. 


@ OTHERS: cal, pr and printer spooler. 


MaxWare 


MAXimum Values SoftWARE 
1265 Payne Drive, 
Los Altos, CA 94022 





Copy files with: subdirectories, multiple 
volumes, only the new files, verbose. 


List the files and display the free disk 
spaces in many formats. 


Remove multiple files or subdirectories. 


Show subdirectory differences, support 
large text file comparison. 


On-line help and examples. 
Easy to use and fast. 





ONLY: $179 for OS/2 & DOS, 


$99 for DOS 3.X, 2.X 


(415) 960-1150, FAX (415) 966-1786 


TRADEMARKS: OS/2, PC/DOS are trademarks of IBM, MS OS/2, MS DOS are trademarks of Microsoft, UNIX is trademark of AT&T 
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lists the top 20 words. Another com- 
mand lists the stack size and the 
high-water mark, handy for diagnos- 
ing crashes due to stack overrun. 
This debugger understands aggre- 
gate data structures. You can dis- 
play a structure by name, listing its 
fields and data types, and fetch any 
of the fields’ values. The same is 
true of arrays, which can _ be 


dumped as a whole, by row, or by 
individual element. 

One of the best features of Soft- 
Scope is pointer dereferencing. This 


allows you to follow an indirection 
chain by dereferencing a series of 
pointers to an object, whose value 
appears on the screen. You can also 
view the resolved address to find 
out if you've got a screwy pointer. 
The pointer dereferencing notation 
is pure Pascal, which might con- 
found those without a Pascal back- 
ground. Still, it’s not difficult to 
master. If INTPTR is a pointer to an 
integer, then the value of the integer 
is represented by INTPTR‘’. Similarly, 
STRUCT’ .FLD*.OBJ is an indirection 





“Simply the BestkText Edit 
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DON’T . settle for an editor that only supports C! 

































Edit 20+ files larger than memory 
Powerful high level macro language 
Oninetélp = 
Online tutorial _ 

Choice of keystroke om 
Function Key assign nents 
WP Functions : . s _ 
Complete DOS shell __ . : 
Pop- up BO ice Caloulator and 
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FINALLY, 
the power of a programmable editor like BRIEF wi 


- settle for an editor that lacks complete WP functions to handle all your documentation needs! 
- settle for an editor that forces you to read the manual to figure out how to get on-line HELP! 
- settle for an editor with a cryptic, unconventional macro language syntax! 


Multi-Edit’s intuitive user interface lets you start productive editing IMMEDIATELY! 
You needn't even pick up the manual! 


-Allocates al available memory to compile when run from. 


Plus Multi-Edit has: Line and column-oriented block operations, reguiar expression search and replace, 43-line EGA mode support, flexible print 
formatting and control, full undo, line drawing, And MUCH, MUCH MORE! 


Multi-Edit Combines POWER with EASE of USE like no other editor on the market! 


e Get our FULLY FUNCTIONAL DEMO Copy for only $10! e 


To Order, Call 24 hours a day: 1-800-221-9280 Ext. 951 * In Arizona: 1-602-890-1166 
Credit Card and COD orders accepted 


AMERICAN CYBERNETICS - 138 Madrid Plaza, Mesa, AZ 85201 


Requires IBM PC/XT/AT/PS2 or fully compatible, 256K RAM, PC/MS-DOS 2.1 or later. Multi-Edit and American Cybernetics are 
trademarks of American Cybernetics. BRIEF is a trademark of Underware. Inc. 
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Copyright 1987 by American Cybernetics. 


CIRCLE NO. 180 ON READER SERVICE CARD 


chain in which STRUCT points to 
FLD, which points to OBJ. 

Another feature worth mention- 
ing, is Soft-Scope’s ability to route all 
of its prompts and displays to an 
external RS-232 terminal. This fea- 
ture makes the program well suited 
for debugging programs which are 
highly interactive with the screen 
cursor position or are graphical in 
nature. 

Soft-Scope’s primitive user inter- 
face is usually not a_ problem. 
Indeed, elaborate displays such as 
CodeView’s often dazzle the eye and 
thus get in the way. It would be 
nice, though, if you didn't have to 
halt the trace in Soft-Scope and type 
a command to examine registers 
and variables. Also, the inability to 
switch display pages in Soft-Scope 
means that program and debugger 
output get mixed together, which 
can lead to a wild jumble. 

Soft-Scope has 37 commands, 
most of which have several optional 
modifiers. The program acknowl- 
edges human frailty to the extent of 
furnishing a HELP command that 
accepts an argument. For example, 
“HELP SUBMIT” furnishes a synop- 
sis of the command syntax for exer- 
cising a debugger script file. 

But until you're a certified Soft- 
Scope guru, you can't effectively 
work this debugger without the 
manual at your elbow. The docu- 
mentation is readable if a bit terse. 
There are 305 pages of tutorials 
using several programming _lan- 
guages, and the command reference 
is 98 pages. A major gripe with the 
manual is that it lacks an index. 

Soft-Scope comes in several fla- 
vors. The one I reviewed is for MS- 
DOS. There are also incarnations for 
the likes of RTCS/UDI and iRMX. 
Prices range from $500 for the DOS 
version up to $2000 for the Intel 310 
with iRMX 286 OS, and considerably 
higher than that for versions work- 
ing with the Applied Microsystems 
ES 1800 emulator. Clearly, this is a 
debugger for serious developers. 

Despite its no-frills, macho inter- 
face, Soft-Scope delivers for those 
who can afford it. 

by Kent Porter 
(continued on page 124) 


Dr. Dobb's Journal, February 1988 





OTT Tt ; : 
4 : * oer RII eet OIE 


ye e222 








THE ANSWER TO YOUR PC'S PRAYERS. 


386 SPEED —ONILY $1,495 


Don't let your PC give up the ghost — Hauppauge has just 
arrived with a new spark of life: the 386 MotherBoard. Our 
new MotherBoard graces your PC, PC/XT or compatible with 
speeds equal to the IBM PS2 Model 80. And faster. Because 
we've built in 1 Megabyte of high speed RAM and a 387 math 
coprocessor socket for speeds that make even irreverent 
users humble with awe. 

OS/2 Compatible To ensure a long, fruitful life, our 
386 MotherBoard is compatible with the PC/AT (BIOS and 
I/O) — allowing you to run the new generation of DOS, OS/2. 
Equally inspiring, our MotherBoard runs Windows/386, 
UNIX V and PC-MOS/386. And if you need more power, 
you'll find two 16-bit expansion slots that accommodate the 
latest I/O expansion card. No 386 accelerator card gives you 
so much versatility. Only our 386 MotherBoard gives 
your PC a future with unlimited possibilities! 


Technical Features = 16 MHz 80386 = 1 Megabyte 
of 100 nsec 4-way interleaved RAM = PC/AT compatible 
I/O and BIOS for support of OS/2 = Six 8-bit expansion. 
slots * Two 16-bit expansion slots = One 32-bit expansion 
slot for up to 12 Megabytes of high speed memory = Battery- 
powered clock calendar = Optional 16 MHz 80387 math 
coprocessor ($695). 


‘Judged on price, performance, and ease of installation, 
the Hauppauge 386 MotherBoard is easily the Upgrade 
Product of the Year.” 

— Robert Luhn, PC World 


For more information on our easy-to-install MotherBoard, call: 
1 (800) 443-6284. In New York, call (516) 434-1600. 


Hauppauge Computer Works, Inc. Ff=yy y ude! 
175 Commerce Drive, —-— 
Hauppauge, New York 11788 sqsset 
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(continued from 


XO-Shell 


Target: 

PC or PS/2 and compatibles 
Requires: 

DOS 2.0 or later 

Pricing: 

$49 

Vendor: 

Wyte Corp. 

701 Concord Ave, 

Cambridge, MA 02138; (617) 868-7704 
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build MS-DOS applications on a 
_ VAX or workstation. OASYS guarantees 


that the unsurpassed speed, compactness, 
and flexibility of Microsoft C have been 
preserved. The OASYS/Microsoft Cross 
C Development System offers identical 
functionality to Microsoft C -- no short 
-cuts, no alterations -- repackaged to meet 
today’s demands for high performance/ 
low cost development on non-MS-DOS 
systems. 
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BY once in a while you run 
across a smoothly crafted little 
program and you just hate the guys 
who dreamed it up: Why couldn't I 
have thought of that? The only con- 
solation is that it’s probably almost 
as much fun to use as it was to 
write it. 

XO-Shell is such a program. I’m 
not sure what to call it. It’s not 
really a debugger, nor is it exactly a 
DOS shell. The vendor refers to it as 
a programmer’s productivity aid. 
Okay, but it could be a productivity 





ae os 
ate te, 


tools, on the widest variety of hosts, with 
comprehensive support. Our exclusive 
relationship with Microsoft, the world’s 
leading supplier of MS-DOS software 
products, is evidence of our commitment 
to provide evolving PC tools to OASYS 
customers. 


Prices start at $1,000. New ports are 
underway Call today for more informa- 
tion. OEM and end-user inquiries are 


encouraged. 
Microsoft: 


230 Second Avenue, Waltham, MA 02154 (617) 890-7889 


MS-DOS, Microsoft and the Microsoft logo are registered trademarks of Microsoft Corp. 
Apollo is a trademark of Apollo Computer Inc. Trademarks are also acknowledged to 
DEC, Sun Microsystems, Inc., XEL, Inc. 
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tool for non-programmers, too. Agree- 
ment on one point is assured: XO- 
Shell is slick. It does a lot of stuff 
that you wish DOS and/or your 
editor would do. 

I tend to have an allergic reaction 
to TSR’s (Terminate-and-Stay-Resi- 
dent programs). They can so over- 
load memory with conveniences 
that you don’t have enough left to 
do real work. And so I viewed XO- 
Shell with a certain wariness, espe- 
cially in view of its 88K requirement. 
To exact that kind of price, I figured, 
it'd better be good. 

Your jaundiced reviewer was pleas- 
antly surprised. There’s a whole 
host of goodies that make that 88K 
worth the cost. On the more prosaic 
side, XO-Shell stores up DOS com- 
mands for recall, edit, and re-execu- 
tion, and it has a file viewer similar 
to Xtree and other DOS shells. What 
sets XO-Shell apart from other shells 
is that you can do this stuff from 
within an application such as an 
editor or the Turbo/Quick environ- 
ments. But that’s not all. 

Say youre editing a program 
module and you've forgotten the 
exact spelling of a variable defined 
in a different module. With XO-Shell, 
you can pop up the other module 
and check it, or print out a portion 
of that code, without leaving your 
edit session. Whoops! You just no- 
ticed an error in the other module. 
No sweat, XO-Shell lets you correct 
it on the spot, then escape back to 
your main editing job. All it takes is 
the Alt-n hot key and a few key- 
strokes. 

Last month you wrote a nifty little 
algorithm, and now you need to 
plug it into your latest masterpiece. 
Position the cursor where you want 
it to go, bring up that old file with 
XO-Shell, and mark the text with 
some Wordstar-like commands. 
When you leave XO-Shell, it copies 
the marked text into the new pro- 
gram, effecting a clipboard. 

Maybe you remember the name 
of that algorithm, but not the name 
of the source file containing it. XO- 
Shell has a grep-like facility to search 
file groups for a specific string. Func- 
tion keys direct the search results 
to the screen, the printer, or a file, 
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“Multiple windows: 


“Emacs runs on 
MS-DOS, VMS 
and UNIX. It’s my 
company’s standard 

editor.” 








“Lcan run a shell or DCL 
command session even 
while editing,” 





“A hundred times better 
than the UNIX vi editor.” 





“Programming modes 
to assist me in writing C, 
Pascal, ADA and Lisp.’ 





“UniPress really 
supports Emacs on 
Berkeley and AT&T UNIX, 
and is constantly 
developing Emacs:”’ 





“| can associate any 
command to any 
keystroke sequence:’ 





“Emacs automates the 
code-compile-edit- 
debug process.’ 


No Iwo Users Can Agree On Why 
UNIPRESS EMACS" 
Is The Only Choice. 


Now Supports 


That's right. No two users can agree on why they’ve 
chosen UniPress Emacs. UniPress Emacs provides so 
much for creating and modifying programs, documents 
and other text files. No other program has such power- 
ful facilities. And we offer Emacs for UNIX™ Xenix™ 
Ultrix™ MS-DOS™ and VMS™ systems. 


UniPress Emacs gives you all the basic text editing 
commands, and goes much further. It allows multiple 
windows to display several files or portions of the same 
file simultaneously, a program’s output, a shell/DCL 
window, a help window, an error listing, an electronic 
mail message, or anything else! 


UniPress Emacs simplifies programming with its C, 
Pascal, ADA and Lisp modes. It checks for balanced 
parentheses and braces, and indents and reformats 
code as needed. “C mode” produces templates of con- 
trol flow in user-definable styles. After compiling, 
Emacs collects any compiler error output in a window. 


Trademarks of: UniPress Emacs & MLisp, UniPress Software, Inc.; UNIX, AT&T Bell Labora- 


tories; VMS, & Ultrix, Digital Equipment Corp.; MS-DOS, Xenix, Microsoft. 


X Windows and Suntools 
Pop-up Menus 


On Any Terminal 


Emacs then analyzes this error output and automat- 
ically displays the erroneous source lines, one-by-one. 


In addition, Emacs offers great extensibility through 
macros and the built-in compiled MLisp™ program- 
ming language. The MLisp language provides looping, 
conditional testing and other flow control statements, 
and a rich set of logic, arithmetic and string operations 
which can be combined. 

If you're still not convinced about UniPress Emacs, 
call us at 800-222-0550 (Outside NJ) to find out about 
our dial-in demo machine or send in the coupon to 
get more product information. We'll send you our free 
catalog with information about Emacs and our other 
UNIX software products. 


UniPress Software, Inc., 2025 Lincoln Highway, Edison, 
NJ 08817. Telephone: 201-985-8000. Order Desk: 
800- 222-0550 (Outside NJ). Telex: 709418 


iniPressScoftware 





CIRCLE NO. 183 ON READER SERVICE CARD 


“Electronic mail is only 
one of the many included 
packages | use”’ 


“| can create my 
own customized editor 
commands with 
the MLisp extension 
language:’ 
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InterTools 


Time Saving Software 
For Embedded System Development 

68000/010/020, 8086/186/286 
68HC11, Z80, V Series 


C Cross Compilers 


e Global Optimization e Utilities include 
Features Linkers, Locators, 

e Produce Re-entrant, Formatters, and Unique 
ROM-able Code ROM Processor 


Cross Assemblers 


e Full Macro Capabilities | ° Support Relocatable, 
e Include Complete Combinable, and 
Utilities Set Absolute Segments 


XDB Cross Debuggers 


e Debug atC or Assembly © Powerful Assertion, 


Source Code Level Breakpoint Commands 
e User-Friendly Interface © Direct Command 
and Command Set Interface to Emulator 


InterTools are available Intermetrics, Inc. 

for VAX, SUN, Apollo, Software Products Division 

HP, IBM PC, and other 733 Concord Avenue 

engineering computers. Cambridge, MA 02138 
(617) 661-0072 

Demo Disks available. Toll-Free: 1-800-356-3594 
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EXAMINING ROOM 
(continued from page 124) 

















and you can save the files list for 
future use in wide-ranging searches. 
XO-Shell also searches the file cur- 
rently being worked on, in case your 
editor lacks this elementary capabil- 
ity. 

Few things are as annoying as 
having to leave an edit session and 
list the directory simply because you 
forgot the name of an include file or 
data file. XO-Shell lets you list a 
directory while editing. It can also 
search directories to find a specific 
file if you can’t remember which sub 
it’s in. And if, while browsing among 
files, you decide it’s time to clean 
up some directories, XO-Shell has 
the ability to copy and erase. When 
youre done, hit Esc and resume 
editing. 

So now the program is done, but 
there’s a variable name you want to 
change, or maybe one that’s de- 
clared but possibly not used. Pop 
into XO-Shell and do a cross-refer- 
ence listing among the program mod- 
ules. It lists every line, identified by 
file, where the variable occurs. 

There are other things as well. For 
example, XO-Shell can save output 
screens from your program in a disk 
file) and restore them later for 
double-checking. For another, 
there’s a pop-up via Alt-m_ that 
shows all 256 characters; pick one 
from the display and plug it into 
your edit screen. Even if your editor 
can’t generate graphics characters, 
you can incorporate them into the 
text this way. And XO-Shell lets you 
drag them around and replicate 
them, providing for text boxes and 
other visual effects in source list- 
ings, as well as direct encoding of 
special characters in string literals. 

Aside from the hoggish 88K, my 
only criticism of XO-Shell is that the 
helpful hints on the prompt line 
(which appears only in response to 
the hot key) aren't very helpful. Such 
things as “F9:Chng para” are far 
from intuitive, even for C cowboys. 

XO-Shell has won its way into my 
programming toolkit, and I recom- 
mend it. 

























































by Kent Porter 
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Our front end helps protect 


Today’s users require sophisticated 
interfaces for their applications. 
Yet complex front ends are a real pain 
to create, especially when the specs 
change and your deadlines don’t. 

But now J YACC introduces JAM™ 
a powerful 
user inter- 


ment tool 
that makes 
it easier 
than ever 
Use windows and colors to design 
Sreely with JAM. and revise 
your complex applications. 

JAM is the first tool that does it all, 
from prototyping to implementation. 
With JAM, you start by creating 
screens and linking them together to 
develop an application shell. You can 
experiment with the look of the inter- 
face, and even explore ‘“‘what if” 
scenarios on the application flow. 
Then you attach processing routines, 
and your application is complete. 





face develop- 


> JAM works under the following operating systems: 


© UNIX® © XENIX® 
° RMX™ 
° VOS™ 


° MS-DOS® 
° VMS® 


You'll be amazed at how quickly 
your applications spring to life with 
JAM’s interactive screen management 
utility. You can use features like con- 
text-sensitive help, shifting and scroll- 
ing fields, a variety of visual attributes 
and extensive data validations to 
create exciting screens, windows and 
menus—all without writing a single 
line of code. JAM also lets you test 
your prototypes at any time. 

JAM lets you draw from its extensive 
subroutine library to help you write 
processing routines faster. And revi- 
sions to your applications are easier, 


Introducing 





your back end. 


because your subroutines are insulated 
from the data entry and presentation 
details of the interface. 

JAM is extremely portable. It runs 
on almost every computer, from PCs to 
superminis, and works under 6 operat- 
ing systems. This allows you to develop 
consistent interfaces throughout your 
company— 
a significant 
asset to the 
Fortune 500 
companies 
that have 
been using “dd miselias 
JAM for more Enhance applications with 
than a year. context-sensitive help. 

JAM from JYACC. It gets your 
front ends—and back ends—in great 
shape. Call for more information about 


demodikerte. 800-458-3313 


demo diskette. 
JYACC FORMAKER™ JAM’s screen 
manager, 1s also available separately. 
JYACC, Inc., 116 John Street 

New York, NY 10038 212-267-7722 





orrs 





JYACC Application Manager. The Composer for Sophisticated Applications 





Excellence in Syste 


MS-DOS, XENIX: Microsoft Corp.; UNIX: AT&T Bell Labs; RMX: Intel Corp.; VMS: Digital Equipment Corp.; VOS: Stratus Corp. 
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Pak: 






HOTKEY 
A complete set of Terminate 
Stay Resident (TSR) functions that 
help you fo write reliable ‘pop-up’ 
programs. 


Now you can make your 
programs ‘Sidekickable’. Two 
example programs are included, 
a ‘pop-up Calculator’ and a pop- 
up ‘Critical Error Handler’. 


The Hotkey toolkit handles all 
floating point functions in resident 
mode. 


ZORTECH HOTKEY TOOLKIT 


The 32 page manual includes 
an interesting discussion of the 
origin and history of 
undocumented MS-DOS function 
calls, together with a full 
explanation of the theory and 
practical use of TSR’s. 


Only $49.95! State Turbo C or Quick C version.) 


COMMS 


Do you need to incorporate 
serial communications into your 
applications? Yes! Then get this 
inexpensive but highly 
professional COMMS toolkit from 
Zortech Inc. 


Look at the list of features: 
Xmodem, Kermit and ASCII file 
transfer, Hayes modem control, 
VT52, VT100 and ANSI terminal 
emulation, supports up to 8 serial 
ports, speeds up to 19.2k baud 
rate and higher. 








Two demonstration programs 
are included, MINICOM and 
MAXICOM (like Procomm) 
together with the 120 page 
manual and full source code FREE! 


Only $49.95! (State Turbo C or Quick C version.) 


GAMES 


Have you ever wondered how 
to write a chess program? Now we 
reveal the secret algorithms and 
techniques of the masters with this 
dynamic Games toolkit. 


ZORTECH SUPERTEXT TOOLKIT 


OME TET 
AB BEEE 





ick C is the trademark of MicroSoft Inc. 







The package comes complete 
with the full source code to three 
ready to play games of strategy — 
Chess, Backgammon and Wari 
(an ancient African game). 


A comprehensive 
150 page manual 
is provided giving anin 
depth look at the history, 

structure and program if 
design of such Cl 
‘Strategy Games’. 


Only $49.95! 


if 


‘ Sireicm Useloh Oxels 
hh amen nent 


Quick C version.) 


Turbo C is the trademark of Borland Inc. 


PPPTTTTTTTITITTITITITITIT TTT ee 


COCO COE E SEES ESOS S OES EEEESESESEESES SESS ESSESESESEO ESSE EES 


VISA Or MCF ounces 


ZORTECH Inc. 361 Massachusetts Ave, Arlington, MA 02174 
Orders & Enquiries Tel: (617) 646 6703 
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TOOLKITS FOR 


SUPERTEXT 

This is not simply an ‘Editor’ 
toolkit, but a full-blown, 
‘WordStar’ compatible 
wordprocessor with the full 
source code. 


As well as all the normal «a 


a 


editing functions, you will also 
find ‘dot’ commands and full 
printer control. The SuperText 
toolkit handles files of any size 
and allows full on-screen 
configuration. 


Do you need fo incorporate a 
wordprocessor into your 
application? Yes! Then get the 
SuperText toolkit complete with 
full source code and 150 page 
manual now! 


Only $49.95! (State Turbo C or Quick C version.) 


PROSCREEN 


Generate high quality data 
entry screens with the Pro-Screen 
— Screen Designer and Code 
Generator. 


You can draw the data entry 
screen, define the input fields, 
define the input criteria, set screen 
colors and attributes, draw single 
or double lines, make boxes — 
press a few buttons and ‘hey 
presto’ Pro-Screen generates 
the C source code for your 
application! 


Professional applications 
programmers will find this 
versatile utility and it’s associated 
functions invaluable. 


Comes complete witha 
substantial 78 page manual and 
demo programs. 


Only $49.95! (State Turbo C or Quick C version.) 


YN 


Rush me 
these items! 


(| HOTKEY 


| 
ll] PRO-SCREEN | aN 
C7) See |_| CO 


| SUPERTEXT \@\C VIDEO 
FREE SHIPPING — VISA/MC/COD/CHECK 







ORDER HOTLINE (617) 646 6703 


GAs 


Seeeeeeeeeeceeseereseseeesees 


COCOA EES EEEE ESSE EEEEEEEEEEEESEES 


TURBO C & QUICK C 
from ZORTECH INC. 


a 


WINDOWS 

Add super-fast text screen 
handling to your applications 
with the WINDOWS library from 
Zortech Inc. 


Give your applications the 
professional look — with instant 
zooming and exploding windows. 
Incorporate drop-down menus 
and Lotus style menus with our 
easy to use functions. 


Automatically handles 
memory saving and buffering of 
window text. Use any number of 
overlapping windows in your 
applications. Write to any 
window, read from any window, 
close any window, pull any 
window to the top. 


Over 55 functions together 
with a big 85 page manual and 
remember, you get the full source 
code. 


Only $49.95! (State Turbo C or Quick C version.) 




















\ 
new © VIDEO 


Mi Nowlearn C the easy way! 
HE Get the ‘Complete C Video 
Course’ from Zortech Inc. 
together with our big 220 
page workbook. 

Ten 1 hour tapes—36 lessons! 


Easy to follow course, you get 


an excellent introduction to 
the C language. 


Takes you step-by-step up to 


the intermediate and 

advanced levels. 

ME teach yourself at home or the 
office — at your own speed. 


Nonly $2795.00! 


ZORTECH 


N 










N LONDON) FRANKFURT GENEVA 


SSLVLS GALINN 
AHL NI 


QsTIVW al 
AYVSSAO4AN 
ADVLSOd ON 








L2cz10 ‘ssew ‘uoyeg 
LOS X9q *O'd 
"\d9q edI/as Japesy 


YIWWVUYONOUd IVNOISSISOUd JHL YO 


S[OQ], BIEM}j0S 


jo Teumo| s,qqoq 3G 


JASSAYAOV Ad AiVd 38 TMM SDVLSOd 





"SSVW ‘NOL1VG ‘002# LINHSd SSV190 ISHIS 


WW Aldad SSANISNG 









ng 


CISIONnSs 





yi 





Smart Bu 














De 








SALVLS GALINN 
SHI NI 


QaTIVW I 
AYVSSSOAN 
ADVLSOd ON 





L2z1l0 ‘ssey ‘uoyeq 
LOS X09 ‘O'd 
‘ydaq 818s JepReeY 


YINWVAYDOUd IWNOISS340Ud FHI YO 


id te Paar 05 


_—_—_——— 





JASSAYGOV Ag Civd 38 THM ADVLSOd 





“SSVW 'NOL1VG ‘00Z# LINHAd SSV10 LSHI4 


TIWW Aldad SSANISNG 








Start with DDJ 












\ 


Use this card for FREE, FAST information about the 
products and services listed in this issue. Simply circle the 





appropriate numbers below. 
Name 
Title 
Company Phone ( __._ ) 
Address 
City/State/Zip 


26 51 76|101 126 151 176|201 226 251 276/301 326 351 376 
27 52 77)102 127 152 177|202 227 252 277/302 327 352 377 
28 53 78/103 128 153 178/203 228 253 278|303 328 353 378 
29 54 79|104 129 154 179/204 229 254 279/304 329 354 379 
80/105 130 155 180/205 230 255 280/305 330 355 380 

31 56 81/106 131 156 181/206 231 256 281|306 331 356 381 

32 57 82)107 132 157 182|207 232 257 282/307 332 357 382 

33 58 83/108 133 158 183/208 233 258 283/308 333 358 383 

34 59 84/109 134 159 184/209 234 259 284|/309 334 359 384 
10 35 60 85/110 135 160 185/210 235 260 285/310 335 360 385 
11 36 61 86/111 136 161 186/211 236 261 286/311 336 361 386 
12 37 62 87/112 137 162 187|212 237 262 287/312 337 362 387 
13 38 63 88/113 138 163 188/213 238 263 288/313 338 263 388 
14 39 64 89/114 139 164 189/214 239 264 289/314 339 364 389 
15 40 65 901115 140 165 190/215 240 265 290/315 340 365 390 
16 41 66 911/116 141 166 191/216 241 266 291/316 341 366 391 
17 42 67 92)117 142 167 192/217 242 267 292|317 342 367 392 
18 43 68 93/118 143 168 193/218 243 268 293/318 343 368 393 
19 44 69 94/119 144 169 194/219 244 269 294/319 344 369 394 
951120 145 170 195/220 245 270 295/320 345 370 395 
21 46 71 96/121 146 171 196/221 246 271 296/321 346 371 396 
22 47 72 97/122 147 172 197|222 247 272 297|322 347 372 397 
23 48 73 98/123 148 173 198/223 248 273 298/323 348 373 398 
24 49 74 99/124 149 174 199/224 249 274 299/324 349 374 399 
25 50 75 100/125 150 175 200|225 250 275 300/325 350 375 400 


February ’88: Use before May 31, 1988 


OON ODOR WM — 
a) 
Oo 
on 
nn 





1. Did you buy this issue on anewsstand?( )Yes({ ) No 

2. Are youasubscriber?( )Yes( )No 

3. Have you purchased a product as a result of seeing it advertised 
in Dr. Dobb’s Journal?({ = )Yes( = )No 


Dr. Dobb's journal of 


FOR THE PROFESSIONAL PROGRAMMER 


@qddddddddddddddd 


Use this card for FREE, FAST information about the 
products and services listed in this issue. Simply circle the 
appropriate numbers below. 


Name 
Title 
Company 
Address 
Ciy/Siate/Zip 


26 51 76(101 126 151 176|201 226 251 276/301 326 351 376 
27 52 77\102 127 152 177|202 227 252 277/302 327 352 377 
28 53 78/103 128 153 178/203 228 253 278)303 328 353 378 
29 54 79/104 129 154 179|204 229 254 279/304 329 354 379 
801105 130 155 180/205 230 255 280/305 330 355 380 

31 56 81/106 131 156 181/206 231 256 281/306 331 356 381 

32 57 82/107 132 157 182/207 232 257 282|307 332 357 382 

33 58 83/108 133 158 183/208 233 258 283/308 333 358 383 

34 59 84/109 134 159 184/209 234 259 284|309 334 359 384 
10 35 60 85/110 135 160 185/210 235 260 285/310 335 360 385 
11 36 61 86/111 136 161 186/211 236 261 286/311 336 361 386 
12 37 62 87/112 137 162 187|212 237 262 287)|312 337 362 387 
13 38 63 88/113 138 163 188/213 238 263 288/313 338 363 388 
14 39 64 89/114 139 164 189/214 239 264 289/314 339 364 389 
15 40 65 90/115 140 165 190|215 240 265 290/315 340 365 390 
16 41 66 91/116 141 166 191/216 241 266 291/316 341 366 391 
17 42 67 921/117 142 167 192|217 242 267 292/317 342 367 392 
18 43 68 93/118 143 168 193/218 243 268 293/318 343 368 393 
19 44 69 94/119 144 169 194/219 244 269 294/319 344 369 394 
20 45 70 95/120 145 170 195/220 245 270 295/320 345 370 395 
21 46 71 96/121 146 171 196/221 246 271 296/321 346 371 396 
22 47 72 97)122 147 172 197|222 247 272 297|322 347 372 397 
23 48 73 98/123 148 173 198|223 248 273 298|/323 348 373 398 
24 49 74 99/124 149 174 199/224 249 274 299/324 349 374 399 
25 50 75 100/125 150 175 200}225 250 275 300/325 350 375 400 


February ’88: Use before May 31, 1988 


1. Did you buy this issue on anewsstand?( ) Yes(  )No 
2. Are you a subscriber? ( ) Yes ( ) No 


2. Have you purchased a product as a result of seeing it advertised 
in Dr. Dobb’s Journal? ( ) Yes ( ) No 


Dr. Dobb's Journal of 


FOR THE PROFESSIONAL PROGRAMMER 








PnOnet 








OOnNMDOA SGM — 
Ww 
oO 
on 
on 








AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 


A 


For Free Info... 








Start Here ! 


Smart buyers start with DDU's free 
information card, a shopping center filled 
with information about the products and 
services advertised in this very issue: everything from software 
and systems to peripherals and professional support services. 

And smart buyers can use this free information card to 
quickly and easily gather a comprehensive file of facts, figures 
and product specs to sort out competing claims. Using DD's 
free information card can prevent you from making the wrong, 
costly buying decision. 

Be a smart shopper. Complete and mail this postage paid 
card today! 
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Microsoit 
Macro Assembler 
5.0 


Target: 
PC or PS/2 and compatibles 
Requires: 

DOS 2.0 or later, hard disk recom- 
mended. Minimum 256K memory, 
320K recommended 

Price: 

$150 

No licensing restrictions on gener- 
ated code 

Vendor: 

Microsoft 16011 NE 36th Wy, 

Box 97017, Redmond, WA 98073 
(206) 882-8080 



















e Fast, EMACS-style commands—completely reconfigurable 
e Run other programs without stopping Epsilon—concurrently! 
eC Language support—fix errors while your compiler runs 

e Powerful extension language  e@ Great on-line help system 
e Multiple windows, files e Regular Expression search 
e Unlimited file size, line length e Supports large displays 

e 30 day money-back guarantee e Not copy protected 


Only $195 
LLUGyJar~Uu 


Software Ltd. 


5843 Forbes Avenue 
Pittsburgh, PA 15217 for IBM PC/XT/AT’s or compatibles 































































he latest release of Microsoft's 
UN vecenbie MASM brings a new 
level of productivity to this most 
tedious of all programming lan- 
guages. It’s loaded with new fea- 
tures, most importantly a bundled 
copy of the CodeView symbolic de- 
bugger. 

Microsoft claims that MASM 5.0 
assembles 25 percent to 40 percent 
faster than 4.0. I didn’t validate this 
with any test suites, but it is 
screamingly fast on an AT: under 
two seconds for a 150-line program 
and about five for an 800-liner, 
which is noticeably faster than ear- 
lier versions of the assembler. 

With release 5.0, MASM now sup- 
ports the instruction sets for all PC 
processors up through the 80386/ 
387. The default mode of the assem- 
bler is the 8086 instruction set; 
pseudo-ops such as .386 and .387 
tell the assembler to honor instruc- 
tions for the indicated targets. If you 
forget to include the appropriate di- 
rective, the assembler scores a 
severe error for each non-8086 in- 
struction and issues a complaint. 

Speaking of pseudo-ops, one po- 
tential gotcha for those migrating 
upward to 5.0 has to do with the 
encoding of floating point numbers. 
Before, MASM encoded real num- 
bers in Binary format. The default in 
5.0 is the IEEE floating point stan- 
dard, compatible with 80x87 math 

















CIRCLE NO. 187 ON READER SERVICE CARD 


LALR generates parsers 


for ADA, BASIC, C, Pascal, Modula 2, SQL, 
dBASE, C++, 386 Assembly, FORTRAN... 


LALR 3.0 is a complete LALR 3.0 includes: 

LALR(1) parser generator. M@ Grammars for ADA, 

It’s fast, powerful, and easy to BASIC, Turbo Pascal and 
use. So, if you’re developing Turbo C. 

a compiler, translator or MM Parser skeleton source code 
language interface, you want with error recovery written in 
LALR. C language.* 

If you just want to learn about [Mf Lexical scanner, syntax 
language translation and checker and calculator source 
state-of-the-art parsing code in C. 

technology, you want LALR. 


60-DAY $Q9 
; MONEY-BACK 
“unbelievably fast ... can GUARANTEE 


handle very large grammars” 


COMPUTER LANGUAGE MAG., DEC. 1985 714-832-LALR 





CB 

v4 LALR Research - 1892 Burnt Mill * Tustin, CA 92680 
. Parser Skeletons may be written in other languages. 

Requires: DOS 2.0 or later, 256K or 512K for large grammars. Overseas orders: Add £10.00. 
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coprocessors. If you still want Micro- 
soft binary format, you have to assert 
the new .MSFLOAT directive. 

Yet another pseudo-op called 
MODEL implements memory 








variables on the stack, segment 
fixups, exit processing, and other 
high-level interfacing needs. The 
macro library is propped up by an 


range of mixed-language program- 
ming issues. 

The overall quality of the manuals 
is much better than any previous 





models, new with MASM 5.0. Its op- 
erands are SMALL, MEDIUM, COM- 
PACT, LARGE, and HUGE, which cor- 


excellent 140-page guide covering a 


Microsoft documentation. In addi- 








Turbo C » C » Functions » ... 


See also: strncpy() 
respond to the models available in : 
high-level Microsoft languages such ae: aide Modo acl oamaa .. 
as C and Pascal, as well as in Turbo finclude <string.h> Required for declarations only = 
C and, to a lesser extent, Turbo : oo : =; 
Pascal 4.0. This addition simplifies nei set yaks tad laches Dostiuaticn sirias 


the assembler interface to other lan- char 
guages, since it generates pointers 
of the correct size for the high-level 
model being used. Clearly, the em- 
phasis is shifting away from assem- — a 
bler as a primary language to assem- 2 eg 
bler as a language for linked high- 
performance subroutines, and this 
addition to MASM recognizes the 
trend. 

To that end, MASM 5.0 furnishes 
a macro library for mixed-language 
programming. This file, MIXED.INC, 
includes macros for passing and re- 
ceiving arguments, allocating local 





*stringZ; 


void addDrive ( char «path ) 
{ 
temp [MAXPATH]; 





Figure 2: MASM 5.0 includes Microsoft's CodeView debugger. 





Source string . y 


/* add drive desig to path */ 


/« temporary string */ 


if ( path [1] t= ’:’ ) { 
strcpy ( temp, path ); 
path [ptt] = disk + 65: 
path [ptt] = ’:’; 
aif ( temp [8] t= ’\V ) 
path [ptt] = ’\V; 
strcpy ( &path [pl], temp ): 
Fi-Help F5-Zoom F6-Message F9-Make F1@-Main wenu 


/* convert to f, B, etc. */ 
/* insert colon */ 


/* and backslash ef 
/* restore the rest */ 
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MHT Software announces a new line of CENGLISH/SK products for the IBM 
PC, featuring, CENGLISH a unique software development system for C. The 
product is available for the Lattice, Microsoft and Borland Turbo C compilers. 
cENGLISH/SK offers a powerful, dBASE-like programming language which is 
translated into C source code. The package also includes a screen generator. 
With a combination of flexibility and ease, CENGLISH/SK is the perfect tool 
for dBASE developers who want to participate in the C revolution. 


ORDER TODAY by calling (714) 528-1602, (Visa/MC accepted) 


or send check or money order to— 
MHT SOFTWARE 


2923 Saturn Street, Suite A, Brea, California 92621 


(30 day money-back guarantee) 
Brand and product names are trademarks or registered trademarks of their respective holders. 
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Documentation 
isa PAIN! 


..- Without DocuMotion™ 


We've found that well indexed and easily accessed 

documentation is a powerful tool and asset. Now you can 

simply pop up DocuMotion to access, display and print your 
documentation. DocuMotion builds indexed document libraries 
from documentation contained in your source code or any text file. 


DocuMotion for programmers: DocuMotion for the PC: 


DocuMotion for project mgrs: 


132 


e Your documentation is available e Runs memory resident or non- 
ANYWHERE, ANY TIME. resident on any IBM PC/XT/AT 
e Access, display and print your or compatible. 
documentation by name or by ® Compatible with all popular 
user-defined categorization memory resident programs. 
trees. ® Requires only 93K RAM. 
® 19 function Microsoft Windows- e LAN compatible. 
style menu bar. 


© Powerful print & copy functions. DocuMotion is for YOU: 


Call NOW 1-612-884-5860 


At a special introductory 


© Programmers produce more and pice of ONLY $159.95 
better documents Hon with ANSI ‘C’ document library. 

® Reduced function redundancy. 

© Greater programmer productivity. 


NWP - Intelligent Solutions, Inc. P.O. Box 20478 Bloomington, MN. 55420-0478 
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tion to the mixed-language guide, 
there are two soft-bound books, a 
467-page Programmer's Guide and a 
401-page volume covering CodeView 
and other utilities. Rounding out the 
documentation is a 148-page wire- 
bound reference divided into five 
tabbed sections. Intended to be kept 
at the programmer's elbow, this ref- 
erence summarizes every instruc- 
tion, pseudo-op, and command-line 
switch. There are several brochures 
and a function-key template for op- 
erating CodeView. 

If you haven’t worked with Code- 
View before, you're missing out on 
the finest thing Microsoft has done 
to date. This is how God intended a 
symbolic debugger to be. It’s a won- 
derfully visual environment that lets 
you watch your code execute while 
keeping an eye on registers and se- 
lected memory locations. CodeView 
runs in a secondary video page, thus 
not interfering with programs that 
do graphics or fancy text screens, 
and you can easily toggle back and 
forth between the CodeView display 
and your program’s output. Accom- 
modating to all and sundry, Code- 
View lets you control it via pull- 
down menus, function keys, typed 
commands, or a mouse: your choice. 

An example of the possibilities 
with this debugger is a thing called 
a watchpoint. You can tell CodeView 
to watch a memory location or even 
a register and, when it changes to a 
specified value (or changes at all), 
CodeView halts and reports the con- 
dition. If you’ve got several watch- 
points and breakpoints set, the Code- 
View display twinkles like Times 
Square on Friday night, but without. 
the chaos; you are actually watching 
your program run. 

CodeView is not specific to MASM 
5.0. It works with all of Microsoft's 
flagship languages: C, FORTRAN, 
Pascal, and QuickBASIC. All that’s 
required is to compile and link with 
certain options, and then you can 
debug an entire application written 
in any combination of these lan- 
guages. Alas, it doesn’t work with 
Turbo languages, but that’s hardly 
surprising. 

MASM 5.0 doesn’t reduce the no- 


toriously finicky detail of program- 
a a ee eee 
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& Windows 


Screens 


Data Input 


DOS 


Interface Handling 


C-Worthy Interface Library helps you smoothly pull together all aspects of an excellent Human Interface. 





C Programmers: Wrap an Exciting, 
Bullet-Proof Interface Around 
Your Code Quickly. 


Introducing... 
C-Worthy® Interface Library 


The only human interface package 
you need. That’s what our customers 
are telling us. One early adopter, 
Novell, Inc. uses it exclusively in the 
development of their NetWare® 
Utilities, which reach over 500,000 
users. You see, C-Worthy Interface 
Library is the only library available to 
handle every aspect of your program’s 
human interface, all in one package. 
Now your programs will have a 
consistent look and feel. You no longer 
have to integrate pieces of libraries 
from different manufacturers. 

As important as you know users are, 
you often don’t have the time to heavily 
invest in writing routine code. And 
that’s OK, because with over 400 tight, 
ready-to-use functions, C-Worthy 
Interface Library takes care of the 
tedium and lets you spend your time 
doing what you enjoy. Concentrate on 
the heart of your application — features 
that make it unique, special. Let 
C-Worthy Interface Library do your: 

e Menus 

e Error Handling 

e DOS Interface 

e Context Sensitive Help 
e Screens, Windows 

e Forms, Data Input (optional 

You control color, size, border, 
location, etc. And if there’s anything 
you want to change, you can. Source is 
available to provide you with the 
flexibility you need. And you can 
distribute your applications freely, with 
no royalties. 


C-Worthy Interface Library requires hard disk media with 256K 
RAM. MSDOS 2.0 + and IBM PC, or compatible, TI Professional, 
NEC APC IIL, or VICTOR 9000. C-Worthy is a registered 
trademark of Custom Design Systems, Inc. 


Tech Specs 

™ Compilers: Microsoft 3.0+, Quick, Turbo, 
Lattice. All models. 

w> 350+ functions written in C, 75+ in 
Assembler. 

w Menus: Fully support pop-up, Lotus style, 
MS Windows style (pull-down), pull-up. 

@ Errors: DOS, program, and user. 

zw DOS Interface: 62 functions. File handling, 


dir. and drive management, date & time 
conversion, wildcards, more. 


Help: System and context sensitive. 


ws Screens: Screen display, color palettes, save, 
restore, scroll, more. 

™ Windows: Exploding, tiled, pop-up, 
overlapping. Direct video access and virtual. 
Up to 50 active at any time. 


w Keyboard Handling: Regular, function, 
interrupt, background procedures. 


w> Editing: String and word wrap text. 


w= Form Interface Library: 118 functions. 
Over 15 field types, and user definable field 
types. 3 levels of data validation: type, 
multiple field ranges, optional validation 
procedures. Hide, lock, or secure a field. 
Optimal field movement. 

w> Foreign Languages: All text messages in 
separate files for easy translation. 


= Compatible with MS Windows. 
w OS/2 special overlay when released. 


w> Machines: Autodetect for MDA, CGA, 
EGA, VGA, TI, AT&T, Victor. 


w No royalties. 





“I heartily recommend this package.” 
— David A. Schmitt, president, Lattice, Inc. 
Over 400 developers in 16 countries already use it. 


Thorough Documentation 


Indexed alphabetically and by category, 
the 700+ page Reference Guide includes 
for each function: an example, description, 
calling conventions, return values, and 
related functions. The 250 page User’s 
Guide gets you going with its tutorial 
and “Getting Started” sections. 
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“C-Worthy is a comprehensive C library whose 
time has come. I heartily recommend it as your 
next purchase.” —Computer Language, 8/87 





C-Worthy Interface Library: 


ler nay Ss ois ug eee Reka $ 195 
Form Interface Library add-on..... $ 100 
Object with Forms ............... $ 295 


Object with Forms & Library Source. . ..$ 495 


Please specify compiler and version when ordering. 





To Order Call 


(800) 821- 2492 
in MA (617) 337-6963 


Solution 
Systems 


541-D Main Street, Suite 410 
South Weymouth, MA 02190 





















































TRUE 


MULTITASKING 


With 
MultiDos Plus 
“multitasking for the IBM-PC.” 


Ideal for developing applications 
in process control, data acquisi- 
tion, communications, and other 
areas. Check these features which 
make MultiDos Plus an unbeat- 
able value. 


e Run up to 32 programs concur- 
rently. 

e Your software continues to run 
under DOS. No need to learn a 
new operating system. 

e Use the compilers you already 
have. Supports software written in 
most languages. 

e Operator commands to load/run 
programs, change priority, check 
program status, abort/suspend / 
resume programs. 

e Programmatic interface via INT 15H 
for the following. 


* Intertask message communica- 

tion. Send/receive/check mes- 

sage present on 64 message 

queues. 

Task control by means of 

semaphores. Get/release/check 

semaphores. 

* Change priority-256 priority 

levels. 

Suspend task for specified 

interval. 

Spawn and terminate external 

and internal tasks. 

Disable/enable multitasking. 

and more! 

e Independent foreground /back- 
ground displays. 

e Access to DOS while applications 

are running. 


* 


Hardware/Software Requirements 
IBM PC/XT/AT or true clone. Enough 
memory to hold MultiDos Plus (48 
KB) and all your application programs. 
Also may need 4 or 16 KB memory 
for ‘hidden screens’’ for each active 
task. MS-DOS (or PC-DOS) 2.0 or 
later operating system. 


only: $24.95 or 
$99.95 


with source code 









Outside USA add $5.00 shipping and handling. 
Visa and Mastercard orders only call 
toll-free: 1-800-872-4566, ext. 350., or 
send check or money order to: 


NANOSOFT 


13 Westfield Rd, Natick, MA 01760 
MA orders add 5% sales tax. 
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(continued from page 132) 


ming in assembly language, but it 
makes for more productive tedium. 
by Kent Porter 


CheckMate 





Target: 

PC or PS/2 and compatibles 
Requires: 

DOS 2.0 or later, hard disk recom- 
mended 

Price: 

Annual fees for single-user, depart- 
ment, and site licenses start at 
$5,750; demo version available. 
Vendor: 

Cinnabar Software 

2704 Rio Grande, Ste. 1, Austin, TX 
78705 (512) 477-3212 





heckMate is a quality assurance 

tool which runs on a PC or 
compatible allowing a tester to easily 
set up automatic scripts for testing 
communications. CheckMate is in- 
tended to test the host computer or 
communications service (hardware 
or software) to which the PC is at- 
tached. : 

At the highest level, CheckMate 
consists of a terminal program. Un- 
fortunately, CheckMate does not emu- 
late any of the popular intelligent 
terminals such as the VT100 (this 
feature is scheduled for inclusion in 
the summer of ’88). It does, however, 
provide a lot more control than is 
normal with such programs. All com- 
munication parameters are accessi- 
ble. In addition, a high level screen 
log and a detailed screen trace 
record all that is happening, both 
from the keyboard and from the com- 
munications ports. Turn your 
modem off or drop carrier and its 
instantly recorded on the trace. 

CheckMate also provides a cap- 
ture mode. In this mode, the user 
goes through a normal communica- 
tions sequence. CheckMate makes 
detailed notes on what was entered 
at the keyboard and what was re- 
ceived at the COM ports, writing 
this information into a “script’’ file. 
During replay, CheckMate makes the 
keyboard entries and compares the 


results with what it expects. Check- 
Mate also notes changes in line 
status such as Carrier Detect or 
changes in baud rate. The executing 
sequence can be viewed in progress 
from the trace screen. Deviations 
from the expected are noted in the 
log file. Both the log and the trace 
can be recorded on disk for later 
perusal or as an testing audit trail. 

CheckMate is designed to allow 
the user to set up scripts for testing 
every feature of his product. With 
such scripts, the user can build a 
test suite for acceptance testing of 
the program or service. This suite 
can be built upon as each new gen- 
eration is developed. In this way, 
the tester is assured that no existing 
features have been “broken” by new 
additions. These scripts can also be 
used as a routine status check or to 
“attack” the system, running the 
same sequence over and over until 
a failure occurs. 

Unlike most other communica- 
tions software, however, CheckMate's 
script files are recorded in Microsoft 
4.0 compatible C source code (an 
example script, created by Check- 
Mate but with comments provided 
by Cinnabar, appears in Listing One). 
To play a script back, the user must 
exit CheckMate, compile and link 
the C program into an executable 
file that can then be played back 
from within the program. Check- 
Mate is intended to handle large, 
carefully designed scripts which the 
user might run hundreds of times. 
The time to compile might be a 
nuisance during the actual develop- 
ment if it takes multiple iterations 
to get the script right. 

For this, the user gets some pretty 
significant advantages. Compiled 
scripts run faster with better timing 
control than an interpretive script 
can. Roughly half of the user manual 
is devoted to a description of the 
system calls available to the Check- 
Mate programmer. In _ addition, 
CheckMate’s scripts can be edited 
by a C programmer to add any extra 
features desired. The complete C 
language is at the programmer’s dis- 
posal. 

While not for everyone, Check- 
Mate should be an interesting prod- 
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Why We're Betting 
a Million Lines of Gode on 
the SAS/C Compiler. 








At SAS Institute Inc., we’ve invested And when we combined these OS or CMS, for a free 30-day evalua- 
more than 10 years of research—and _ features with outstanding technical tion. We'll also send you a free copy 
over a million lines of code—in the Support and frequent updates —both of a leading benchmark program. Com- 
SAS® System, the world’s leading data provided free—software developers pare our compiler with any other. Odds 
analysis software. So you can bet we everywhere took notice. The SAS/C are, you'll choose the SAS/C compiler. 
left nothing to chance when we chose _ compiler is now the market leader, Just mail the coupon below. Or call 
the C language for the next generation _ installed in hundreds of commercial your Software Sales Representative at 
of our software. firms and academic institutions. (919) 467-8000. 


We selected C for the portability it 
would bring to the SAS System, but Test It Compare It 


weren't about to risk our code on just 


any mainframe C compiler. So we tried FREE for 30 Days. 


them all. When none could meet our 





exacting requirements, we created our | 7 SAS Institute Inc. 

own: the SASIC compiler We're betting you've set the same _ ste oe eit Apne Te 
high standards. That’s why we’d like Phone (919) 467-8000 
to send you the SAS/C compiler, under ® Fax (919) 469-3737 

We Developed It. : ; a 


Support It. Use It. 


Using a C version of the 


The SAS/C compiler set new standards sah cs SAGE concn nyerage Loons Per igi ta 
for efficiency and technical quality, with: — release produces the fastest 

w= A source-level debugger that code among the top 3 

includes structure display, ABEND mainframe compilers. It even 

recovery, and debugger |/0 exits for fops our own previous | sas/c 3.01 


debugging specialized applications release by 35%. | waterloo c 
=== Reentrant object code 

m= Highly optimized generated code 

m= (se of standard IBM linkage nent eee eee eee eee ees 
conventions, with support for 31-bit 


IBM C 





Number of Loops 





addressing 

m= A CMS Rexx/TSO CLIST interface . 

=== Support for signal handling : Id like to put the SAS/C™ compiler to the test with a free 30-day trial, and 
including program checks and terminal : my free copy of the Dhrystone benchmark program. Give me the details. 


interrupts, and non-standard signals 


nagcege Please complete, or attach your business card. 
such as timer interrupts and stack 


oye Name Title 
=== Many built-in functions including 
String handling 3 Company 
wm |n-lineé assembler. : Address 
- City State ZIP 
Telephone 
SAS is a registered trademark of SAS Institute Inc., 
Cary, NC, re SASIC is a trademark of SAS Institute. : Mail to: SAS Institute Inc., Attn: CC, SAS Circle, Box 8000, 


Copyright © 1987 by SAS Institute Inc. Cary, NC, USA, 27512-8000 
Printed in the U.S.A. 
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uct to those companies which pro- | The sitngle CPU lvicense fee for 
vide communications services or | CheckMate is $5,750 per year. A 
which make heavy internal use of | demo version can be ordered for 
serial communications. CheckMate | $49.95. CheckMate requires 320k and 
can also be used to test mainframe | DOS 3.1 or better to run. 

software by simulating multiple by Randy Davis 
users logged into serial terminals. 

SQL Compatible Query System adaptable to any CheckMate comes on two floppies DDI 

a within a 8.5-by 11-inch 3-ring binder. 

CQL Query System. A subset of the Structured 
English Query Language (SEQUEL, or SQL) 
developed by IBM. Linked files, stored views, 
and nested queries result in a complete query 
capability. File system interaction isolated in an 
interface module. Extensive documentation 


guides user development of interfaces to other 
record oriented file handlers. Check *Mate header k/ 








Portable Application Support System 


main(argc, argv) 
Portable Windowing System. Hardware int argc; 





independent windowing system with borders, 
attributes, horizontal and vertical scrolling. 
User can construct interface file for any char ‘argv[]; 
hardware. Interfaces provided for PC/XT/AT 
(screen memory interface and BIOS only { 
interface), MS-DOS generic (using ANSI.SYS), 
Xenix (both with and without using the curses int length; /* Declare program vaiables. */ 
interface), and C-library (no attributes). int prevwait; 
/* Set online requirements for the Hayes modem. a 
Screen |/0, Report, and Form Generation 
Systems. Field level interface between PM set(COM1, _SXDCE, SXCTS); 
application programs, the Query System, and /* Set error action parameter to exit the script if any errors occur. */ 
the file system. Complete input/output 
formatting and control, automatic scrolling on PM set (COM1, _ERRACTION, EAEXIT); 
screens and automatic pagination on forms, SX assert (COM1); /* Raise dataset signals and... ‘7 
process intervention points. Seven field types: MX online (COM1) ; /* match for online on COM1. </ 
8-bit unsigned binary, 16 bit signed binary, 16 TX str(COM1, “AT”, YES); /* Send Hayes attention command... ‘*/ 
bit unsigned binary, 32 bit signed binary, MX blk (COM1, "OK", 2, 10, &length);/* and match for “OK" returned. as 
monetary (based on 32 bit binary), string, and CM delay (0.5); /* Wait for Hayes modem to catch up. */ 
date. TX Str(COMl, “AT DI", NO); /* Send Hayes command to dial tone ‘*/ 
Including source Code /* Send the phone number for the modem to dial, which is accessed by ad 
/* the script with the string ’argv[{l1]’. x] 
$395.00 
File System interfaces include TR BCE COM), SGNINT, Yeo) t 
C-tree and BTRIEVE. /* Match “CONNECT” back from modem signaling that host answered. <j] 
HARDWARE AND FILE SYSTEM PM read(COMl, WAIT, &prevwait); 
INDEPENDENT PM set (COM1, WAIT, 60); 
MACHINE MX blk (COM1, "CONNECT", 7, 40, &length); 





INDEPENDENT PM set (COM1, WAIT, prevwait); 
SOFTWARE exit (OK); /* Exit script with success  / 


CoRPORATION 


1415 NORTHGATE SQUARE #21D 
RESTON, VA 22090 


VISA/Master Charge accepted 


(703) 435-0413 


*C-tree is a trademark of FairCom 





IBM, SEQUEL, PC, XT, AT are trademarks of IBM Corp. 
MS-DOS and Xenix are trademarks of Microsoft Corp. 


CQL and the COL !ogo are trademarks of 
Kurtzberg Computer Systems. 





Example 1: C source code generated by CheckMate. 





CIRCLE NO. 193 ON READER SERVICE CARD 


136 Dr. Dobb's Journal, February 1988 


Bring the NR: An Implementation of the 
Unix NROFF Word Processor 
Conveniences 


by Allen Holub 


7 NR is a text formatter that is written in C and compatible with UNIX’s 
oe NROFF. Complete source code is included in the INIR package so that it 


can be easily customized to fit your needs. INIR also includes an imple- 


mentation of the -ms (manuscript) macro package and an in-depth de- 
MS-DOS scription of how -ms works. INIR does hyphenation and simple propor- 
tional spacing. It supports automatic table of contents and index 
generation, automatic footnotes and endnotes, italics, boldface, over- 
Machine striking, underlining, and left and right margin adjustment. INIR also 
contains: 


Ful] Source Code Qin Disk! ¢ extensive macro and string capability 


* number registers in various formats, including Roman 
and Arabic numerals, both spelled out and in outline form 
° diversions and diversion traps (macros that are triggered 
automatically) 
e input and output line traps 
NR is easily configurable for most printers. Both the ready-to-use pro- 
gram and full source code are included. 
ALTE For PC compatibles. 


Unix-Like MS Manual & Disk (MS-DOS) Item #33-X $29.95 


save 15% 


Receive On Command, Util and NR together for only $85.95! 
You get all the convenience of Unix-like features and save 15%. 
Unix-like Features Package item #167 $85.95 











On Command: Writing a Unix- To Order: 
Like Shell Gar MS-DOS Return this order form with your payment to: 


M&T Books, 501 Galveston Dr., Redwood City, CA 94063 
by Allen Holub Or, CALL TOLL-FREE 800-533-4372 Mon-Fri 8AM-5PM 
(In CA call 800-356-2002) 


This book and ready-to-use program demonstrate how to write a Unix- 
like shell for MS-DOS, with techniques applicable to most other program- 
ming languages as well. The book and disk include a detailed description 
and working version of the Shell, complete C source code, a thorough 
discussion of low-level MS-DOS interfacing, and significant examples of 
C programming at the system level. 

Supported features include: read, aliases, history, redirection and pipes, 
Unix-like command syntax, MS-DOS-compatible prompt support, C-Shell- 
based shell scripts, and a Shell variable that expands to the contents of a 
file So a program can produce text that is used by Shell scripts. The Unix- 
like control flow includes: if/then/else; while; foreach; switch/case; break; 
continue. 

The ready-to-use program and all C source code are included on disk. 
For IBM PC and direct compatibles. 


Book & Disk (MS-DOS) Item #29-1 $39.95 
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Address 
Cy CC 





Zip 





Yes! | want to SAVE 15%! Please send me the 
Unix-Like Features Package for only $85.95 
Send me On Command book & disk $39.95 
Util manual & disk $29.95 
NR manual & disk $29.95 
Subtotal 
% 
Add $2.25 per item for shipping 
TOTAL 


\Util 
by Allen Holub 


When used with the Shell, this collection of utility programs and sub- 
routines provides you with a fully functional subset of the Unix environ- 
ment. Many of the utilities may also be used independently. You'll find ex- 
ecutable versions of cat; cp; date; du; echo; grep; Is; mkdir; mv; p; 
pause; printevn; rm; rmdir; sub; and chmod. 

The \Util package includes complete source code on disk and all pro- 
grams (and most of the utility subroutines) are fully documented in a 
Unix-style manual. For IBM PC and direct compatibles. 


Manual & Disk (MS-DOS) Item #12-7 $29.95 


CA residents add sales tax 





[_] Check enclosed. Make payable to M&T Publishing. 
Charge my[{_] VISA [_] M/C [_] Am. Ex. 


Card No. CC 
3136C 
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Debuggers 

Gimpel Software has announced 
Turbo C-terp, a debugging C inter- 
preter that is fully compatible with 
Turbo C. Breakpoints can be tempo- 
rary or sticky; can be specified via 
line number, function name, or 
cursor; and may be conditional. 
Users can step to the next state- 
ment, step over functions, and leave 
the current function; display the 
value of any expression; and execute 
any C expression. C-terp supports 
full K&R (with ANSI enhancements) 
and multiple modules and includes 
a built-in multifile editor, automatic 
make, virtual memory option, and 
shared symbols. The product is 
priced at $139. Reader Service No. 
16. 

Gimpel Software 

3207 Hogarth Ln. 

Collegeville, PA 19426 

(215) 584-4261 


dBFind is a dBASE I, dBASE III, and 
dBASE III Plus debugger from The 
Software Development Factory. 
The debugger identifies missing key- 
words, arguments, and operators; lo- 
cates unbalanced control structures; 
builds a complete index of variables 
by source module and by line 
number and includes type of usage 
for each occurrence; and provides 
command-specific, detailed error 
messages. The price for dBFind is 
$99. Reader Service No. 17. 

The Software Development Factory 
400 E. Pratt St., Ste. 800 

Baltimore, MD 21202 

(301) 666-8129 


Arium Corp. has introduced a high- 
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level C language symbolic debug- 
ging feature for its Echo microproc- 
essor development system C com- 
piler option. This feature allows 
design engineers or programmers to 
debug emulated code in the source 
language, in assembly language, or 
both. The C compiler option with C 
language debug feature is available 
for $495 for the 8-bit unit and $895 
for the 16-bit unit. 

Echo is a microprocessor develop- 
ment system that features a 20- 
Mbyte hard disk, a 1.2-Mbyte flexible 
disk, 1 Mbyte of main memory, a 
full-screen editor with dedicated 
keypad, assemblers, linker and 
loader software, and complete emu- 
lation software. Echo is priced at 
$8,960 for 8-bit processors and at 
$12,980 for 16-bit processors. Reader 
Service No. 18. 

Arium Corp. 

1931 Wright Circ. 
Anaheim, CA 92806 
(714) 978-9531 


Tools and Utilities 

BPTPLUS in C is a-B+Tree data 
manager available from Sterling 
Castle that allows both direct and 
sequential access to data. The pro- 
gram features multiple nonunique 
keys, virtual-index capabilities, par- 
tial key searches, and the ability to 
include 40 indices per index file. 
With the program, users can convert 
BASIC programs’ written’ with 
B+Tree to C programs and have 
access to original BASIC index and 
data files without having to reenter 
data. BPTPLUS is compatible with 
Borland’s Turbo C; Microsoft C, Ver- 
sions 3.0 and 4.0; and Lattice C, 
Version 3.0. Reader Service No. 19. 
Sterling Castle 

702 Washington St., Ste. 174 

Marina del Rey, CA 90292 

(800) 722-7853 

In Calif. (800) 323-6406 

(213) 306-3020 


The Cito 286 programming environ- 
ment is now. available from 
Fillmore Systems. Cito consists of 
an interactive command-line inter- 
preter and macro language and a 
linking feature that allows object 
modules to be dynamically linked 

















into the currently running Cito envi- 
ronment. Users can write, edit, com- 
pile, and link C procedures from 
within the Cito environment. The 
macro interpreter generates execut- 
able machine code for macro defini- 
tions and entry points to dynami- 
cally linked procedures. Cito sup- 
ports conditional testing, high-level 
control structures, file I/O, multi- 
tasking, variables, and arithmetic. Ver- 
sion 1.0 of Cito runs on IBM PC ATs 
and compatibles using Xenix, Ver- 
sion 2.0 (System V). The price is 
$229. Reader Service No. 20. 
Fillmore Systems 

7200 York Ave. S., Ste. 301 

Edina, MN 55435 

(612) 831-6984 


The C-scape On-Line Reference has 
been jointly released by Oakland 
Group and Peter Norton Comput- 
ing. The software is designed to 
work in conjunction with the In- 
stant Access Program of the recently 
released Norton Guides’ and 
Oakland’s C-scape Interface Manage- 
ment System. The Norton Guides 
provides instant on-line reference 
data for four languages: C, assembly 
language, BASIC, and Pascal. C-scape 
is a professional development tool 
for controlling the user interface of 
C programs. The C-scape On-Line 
Reference Guide is available from 
Oakland Group for $50. The pro- 
gram requires the Norton Guides’ 
Instant Access Program, which can 
be purchased from Oakland Group 
or Peter Norton Computing for $50. 
Reader Service No. 21. 

Oakland Group Inc. 

675 Massachusetts Ave. 

Cambridge, MA 02139-3309 

(800) 233-3733 

(617) 471-7311 


C:Lines/C:Tree, from SoftRex, is a 
program that reorganizes and prints 
C source code and provides a struc- 
tural analysis of the code. Features 
included are outlines of all logical 
blocks that are added to the listings, 
detailed cross-references, an auto- 
matic source code reformatter, and 
a hierarchy tree that shows the rela- 
tionships between the various sub- 
routines in code. C:Lines/C:Tree can 
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also generate a listing of unused 
global symbols, preview listings on a 
monitor, analyze interactions be- 
tween overlays, add titles and subti- 
tles to listings, generate an index of 
titles and subtitles, and be config- 
ured for any printer. The program 
runs on IBM PCs and compatibles 
and sells for $59.95. Reader Service 
No. 22. 

SoftRex 

4807 Bethseda Ave., #287 

Bethseda, MD 20814 

(301) 881-8274 


A new coding tool from O'Neill Soit- 
ware called the Text Collector lets 
programmers find, collect, examine, 
and analyze scattered blocks of 
source code. The package searches 
an entire disk or specified groups of 
files for any combination of terms 
and automatically saves all context 
blocks meeting the search criteria. 
Context blocks can be lines of code, 
strings, comments, records, or other 
user-defined blocks of material. File 
names can be appended or prepen- 
ded to blocks, and the blocks can 










Break 
The dBase 
Barrier 


dBase to C conversion 
is now a reality 


be sorted. The program permits com- 
plex searches using Boolean opera- 
tors, nested parentheses, and 14 dif- 
ferent wildcards. The Text Collector 
runs on IBM PCs and compatibles 
with 128K and MS-DOS/PC-DOS 2.0 
or later. The price is $69. Reader 
Service No. 23. 

O'Neill Software 

P.O. Box 26111 

San Francisco, CA 94126 

(415) 398-2255 


The Window Management System 
(WMS) for Turbo C is a high-level 
programming tool that allows effi- 
cient development of easy-to-use in- 
terfaces based on windows, menus, 
and data prompts. B&C Microsys- 
tems is now shipping this program, 
which features a window editor, a 
window librarian, a C interface, and 
DOS utilities. WMS sells for $69.95. A 
demo disk is available for $5 and 
can be credited toward future pur- 
chases of WMS packages. Reader Serv- 
ice No. 24. 

B&C Microsystems 

355 W. Olive Ave. 
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[Tata 
Tx Axis | 


GRAPHICS LIBRARY 
For PC programmers 


Sunnyvale, CA 94086 
(408) 730-5511 







Serengeti Software has _ an- 
nounced Show Me!, a memory-resi- 
dent, file-viewing utility for the IBM 
PS/2, IBM PC, and compatibles. The 
program allows users to list directo- 
ries and view up to four files in- 
stantly; use pop-up help screens for 
virtually any program; look at Word- 
Star document files while editing 
and pass text from a window; view 
multiple source or listing files in 
ASCII or hexadecimal while using 
DEBUG, SYMDEB, or other utilities; 
and add help screens to programs 
using built-in program interfaces to 
BASIC, Pascal, dBASE, and C. Show 
Me! sells for $39. Reader Service No. 
25. 

Serengeti Software 

P.O. Box 27254 

Austin, TX 78755 

(512) 345-2211 





























Languages 
Addison-Wesley has released The 
AWK Programming Language, the 































Viewports 
Loaddrivers 
Line Types 
Line Fitting 
Graphics Cards 











Create custom graphs of any 












Sooner or later you’re going to run into the dBase wall. It may 
come up unexpectedly. Maybe you know it’s there. But at 
some point you are going to need faster run-time, real 
portability, stronger code refinement, and source code security. 







_GEOGRAF 


— coffee 


400 — © cola 
| -@ beer 


type with GEOGRAF’s powerful 
library of subroutines. Plot on 
screen, dot matrix printer, laser 
printer and pen plotter at 
maximum device resolution 
without changing your code. 
FORTRAN version is fully 
compatible with mainframe 
Calcomp graphics library. 
Available for FORTRAN and 
BASIC for all PC compatibles. 























Using dBx to translate your dBase code to C is the perfect way 
to break the dBase barrier. C is portable, fast, and flexible. C 
programmers appreciate our commented, clean K&R code. If 
you are new to C, dBx is a great way to get up to speed. Why 
not call us today and discuss your individual situation. 


Code Written 
& 
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EFFECT OF STIMULANTS ON PROGRAMMERS 














MONEY BACK GUARANTEE 







Mai ‘ , 800-822-2669 
A Sane AL | (203) 2 255-3400 GEOCOMP Corp. 
ee nal TELEX - 6502972226MCI 342 Sudbury Road 


Concord, MA 01742 
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first book on awk, a programmable 
text-manipulation language for writ- 
ing short programs to perform data- 
manipulation tasks. The language 
was originally developed by Alfred 
V. Aho, Brian W. Kernighan, and 
Peter J. Weinberger in 1977. A new 
version of the language, which is 
available for Unix and MS-DOS, was 
developed in 1985. Some of the 
topics covered in the book include 
retrieving, transforming, reducing, 
and validating data; managing small 
personal databases; text processing; 
little languages; and experimenting 
with algorithms. The book sells for 
$21.95. Reader Service No. 26. 
Addison-Wesley 

Reading, MA 01867 

(617) 944-3700 


MHT Software is now shipping 
three new products: the cCENGLISH 
Menu Development System; 
cENGLISH, Version 3.0; and 
cENGLISH for Microsoft C. The 
cENGLISH developer employs Eng- 
lish-like commands that are trans- 
lated into C language source code. 








This C code uses the industry-stan- 
dard C-ISAM access manager and in 
Informix-SOL database management 
system to organize and retrieve in- 
formation. The cCENGLISH Menu De- 
velopment System is an interactive 
utility for building many different 
styles of menus. CENGLISH, Version 
3.0, adds video and printer control, 
text file manipulation, and utilities 
for importing and exporting ASCII 
data. Programmers without C experi- 
ence can use CENGLISH for Micro- 
soft C and benefit from the advan- 
tages of the C language. Prices vary 
according to machine and operating 
system. Reader Service No. 27. 

MHT Software 

2923 Saturn St., Ste. A 

Brea, CA 92621 

(714) 528-1602 


Software Development Systems 
has announced its UniWare Z80 C 
compiler, which was designed to 
help engineers make the transition 
from writing in assembly language 
to writing in C. A special optimizing 
feature of the UniWare Z80 C com- 





piler is its ability to use the Z80's 
alternate register set for storing up 
to three 16-bit user-declared vari- 
ables. The compiler comes complete 
with a macro relocating assembler, 
a linker, an object module librarian, 
and utilities to help programmers 
debug their code and download it 
into emulators and EPROM program- 
mers. The UniWare Z80 C compiler 
running on the IBM PC and compa- 
tibles using MS-DOS or Xenix is 
priced at $995. The compiler run- 
ning under Unix on a variety of ma- 
chines is priced at $2,995. Reader 
Service No. 28. 

Software Development Systems Inc. 
3110 Woodcreek Dr. 

Downers Grove, IL 60515 

(312) 971-8170 


DDJ 





8031 


FORTH DEVELOPMENT ENVIRONMENT 


Take advantage of Bryte’s tools to make your job easier: 


@ Bryte’s development environment uses BRYTE-FORTH 
on the actual production hardware during product 
development. No emulators, no changes, no surprises. 


Optional PC-based cross-development tools use DOS 
files as microcontroller mass storage. These files 
can be used to generate compact EPROM images, de- 

tailed listings, and cross-references. 


Why not start developing the Bryte way today? 


BRYTE-FORTH 8831 EPROM 100.00 
(includes 13% page User’s Manual) 

Utility disk(s) 6S 

Cross-compiler/Cross-assembler 

8031 unlimitted quan. license 


* Includes complete source code 


lioryte computers, inc. 


P.O. Box 46 
Augusta, ME 04330-0046 


207/547-3218 
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Make your C language 
programs memory resident 
with 
DMS RESIDENT-C 


Lattice Microsoft 


enable 


“hot-key”’ 


$79.95 $149.95 


w/source 


Make your assembler 
programs memory resident 
with 
DMS RESIDENT-ASM 


enable 


$149.95 
w/source 


American Software International 
P.O. Box 523 
Windsor, CT 06095-9998 
(203) 688-5054 
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The software technology available to 
programmers of IBM-compatible per- 
sonal computers is truly amazing. And 
newer, more powerful development 
packages appear all the time. But until 
now, finding out about these important 
products has been a difficult and time 
consuming task. 


FREE Buyer’s Guide. The New Pro- 


Noncommissioned Staff. Our courteous 
salespeople are always ready to help 
you. And if you aren't sure about your 
needs, our knowledgeable technical 
people can give you sound, objective 
advice. 


Experience. We've specialized in de- 
velopment software for |IBM-compatible 
personal computers since 1984 and 


Upgrade your technology 


are experienced at providing a full 
range of quality products and customer 
services. 


How to Get Your Copy. There are three 
ways for you to receive your FREE 
copy of the Programmer’s Connection 
Buyer's Guide: 1) Use the reader service 
card provided by this journal; 2) Mail us 
a card or letter with your name and 


grammer’s Connection Buyers 
Guide contains individual des- 
criptions of over 500 titles of 
programmer's development 
software by over 150 manu- 
facturers. Each description 
covers major product features 
as well as any software or 
hardware requirements and 
version numbers. In the box on 
the right are some examples of 
the types of descriptions you'll 
find in our Buyer’s Guide. 


No Hidden Charges. The low 
discount prices in our Buyer’s 
Guide are all you pay. We don’t 
charge extra for domestic UPS 
Ground shipping, credit cards, 
COD orders, purchase orders, 
sales tax (except Ohio) or 
special handling (except for 
non-Canadian international 
orders). 


Guarantees. We offer FREE 
30-day no-risk return guaran- 
tees and 30-day evaluation 
periods on most of our 
products. 


Latest Versions. The products 
we Carry are the latest versions 
and come with the same manu- 
facturer’s technical support as 
if buying direct. 


Large Inventory. We have one 
of the largest inventories of 
programmer's development 
products in the industry. Most 
orders are shipped within 24 
hours. 


The 


Copia International 
Peabody 


Pop-up Resident Reference Utility 


List $100 Reg $89 
Special Introductory Price $79 


through 02/28/88 


Peabody is a fast and flexible on-line reference utility with databases 
for Microsoft C, Turbo Pascal and MS-DOS. Peabody spares the 
manual and spoils the programmer by providing instant, accurate and 
complete information in pop-up frames atthe touch of a key. Whether 
you need a simple reminder or a full description and useful examples, 
you'll find it with Peabody. Each database has been designed and 
assembled by seasoned programmers; their applied experience is ob- 
vious in the concise and practical information that unfolds at your re- 
quest in overlapping frames. Peabody gives you two ways of finding 
that information; select general topics from a structured subject menu 
or use Peabody’s unique Hyper-Key to get instant help forthe keyword 
Closest to the cursor. Other special features that make Peabody an 
outstanding value are its ability to reference multiple databases with 
a single keystroke; its Sticky Frame feature, which lets you paste in- 
formation on screen for reference when you return to your editor, and 
display functions which list on screen the contents of disk files and 
computer memory in text or binary formats (ASCII or EBCDIC). 
Peabody canrun asa stan- 
dalone program, in tandem 
with your text editor, or as 
a memory-resident utility. 
The Peabody disk includes 
a setup utility for customiz- 
ing Peabody and a com- 
piler for integrating your 
own subject categories, 
keywords and reference 
material directly into a 
Peabody database. 
Requires as little as 85K 
memory. Comes with a full 
unconditional 60-day 
money-back guarantee. 






address; or 3) Call one of our 
convenient toll free telephone 
numbers. 


If you haven’t yet received 
your Programmer’s Connec- 
tion Buyer’s Guide, act now. 
Upgrading your programming 
technology could be one of 
the wisest and most profitable 
decisions you'll ever make. 


CALL TOLL FREE 
USA: 800-336-1166 


Canada: ...... 800-225-1166 
Ohio & Alaska 

(Collect): .. 216-494-3781 
International: 216-494-3781 
TIO 0338 28 9102406879 


Easylink: .......... 62806530 


Programmer’s Connection 
7249 Whipple Avenue NW 
North Canton, OH 44720 


Please turn the page for our 
latest price list and ordering 
information. Ss 


ProgrammersConnection 
Buyer's Guide. 
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ai-expert systems 


1st-CLASS by Programs in Motion .............. 495 
EXSYS Development Software by EXSYS.......... 395 
LEVELS by /nformation Builders .............44- 685 
Logic-Line Series A// varieties hy Thunderstone... . . CALL 
RuleMaster 2 by Radian Corporation......... New CALL 
VP-EXPERT dy Paperback Software ............. 125 
ai- lisp language 
muLISP-87 Interpreter by Soft Warehouse ........ 300 
muLISP-87 Interpreter & Compiler.............. 400 
Q'Nial Various by MIAL Systems ................ CALL 
Star Sapphire LISP Compiler by Sapiens.......... 495 
ai- prolog language 
Arity Combination Package ................... 1095 
Expert System Development Pkg ............. 295 
File Interchange Toolkit.................... 50 
PROLOG Compiler & Interpreter ............. 650 
Serene: Mase TO es. ge ews es hoe oo 50 
SQL Development Package ................. 295 
Arity PROLOG Interpreter .................... 295 
Arity Standard Preley wc oo ee cae 95 
LPA microPROLOG A// Varieties................ CALL 
MPROLOG P550 w/Primer by LOGICWARE ....... 220 
Turbo PROLOG dy Borland Intl ................. 100 
Turbo PROLOG Toolbox dy Borland Intl........... 100 
ai- smalitalk language 
SUMMERS © nar tds cecda sk oe tawerd ase Baws ges 100 
EGA/VGA Color Option.................... 50 
Goodies Diskette #1 ...................04. 50 
Smnaittath/ Comin Sls olan eo FS olbs oy 50 
ai- texas instruments 
Arborist Decision Tree Software ................ 595 
Pi, NO EEG Eagan hots oo CRE BER 9) 
Personal Consultant Easy..................... 495 
Personal Consultant Images ..................- 495 
Personal Consultant Online ................... 995 
Personal Consultant Plus ..................... 2950 
Personal Consultant Runtime .................. 95 
ada language 
AdaVantage GSA-validated by Meridian Software ... 795 
AdaVantage Utility Packages ................ 50 
DOS Environment Package ................. 50 
Ada GSA-validated w/ maintenance by alsys ... New 3355 
POM Sea ALE ad wie a whee New 200 
Ada Developer's Toolset Volumes? &2.... New 995 
apl language 
APL*PLUS dy STSC, Specify PC or PS/2 ......... 695 
APL*PLUS PC Spreadsheet Mgr by S7SC ........ 195 
ft gM gh Sa os a a top ae ie 295 
ATLAS “GRAPHICS Oy SISC on cies cs eee 450 
Financial/ Statistical Library by S7SC ............ 275 
Pathet APE DV S196, 05 25 4s oe ed tawny end 95 
STATGRAPHICS BY'STSC «oo nn oe ce rclececes 895 
assembly language 
386/ASM/386 LINK Cross Asm by Phar lap ...... 495 
ASMLIB Function Library by BCSoft ............. 149 
asmTREE 8-7ree Dev System by BCSoft .......... 395 
Cross Assemblers Various by 2500 AD :.......... CALL 
DMS Resident-ASM by American Software /ntl...New 150 
Microsoft Macro Assembler ................... 150 
GOPTASM by SLR Systems 5 is can dapeeses New 195 
A DVO aricnk ce cw acd cde nos acces Babes New 80 
Turbo Debugger by Speedware................. 89 
Turbo Editasm by Speedware .............0005. 99 
Visible Computer: 8088 by Software Masters ...... 80 
basic language 
Ramee BF COMBI OD © osc ink ew hin eee New 99 
db/Lib for QuickBASIC by AJS Publishing ......... 139 
Finally by Komputerwerk .... 2.2... eee 99 
MAGH.2 by MicroHelD oi.o5 5 ovina c cone ois jciteayn CALL 
Microsoft QuickBASIC....................... 99 
OBase Ae/ational Database by Crescent .......... 99 
Guick-TOOLS by BOSOM. oc oe er ewes eae’ 130 
QuickPak by Crescent Software ..............4. 69 
Scientific Subroutine Library by Wiley ........... 125 
Screen Sculptor by Software Bottling ............ 125 
Stay-Res by MicroHelp ... 1.0.0... ee ee cee ee 79 
NOOO DAO: cca sess Pivdeased soda o-aee 100 
True BASIC w/Run-time ........ 6.0 cee cece 150 
True BASIC 3D Graphics..................... 50 
True BASIC Developer's Toolkit................ 50 
Turbo BASIC Compiler by Borland /nt/ ........... 100 
blaise products 
ASYNCH MANAGER Specify C or Pascal ......... 175 
C TROLS PIUSISN |.) e207 A Sa aS 129 
KeyPlayer Super Batch Program ............4.4.. 50 
LIGHT TOOLS for Datalight C.................. 100 
PASCAL TGGES/TOGIS 2 oct eke ones 175 
RUNOFF (ext Cag ics oo See eee 2 50 
Turbo ASYNCH PLUS/4.0................... 129 
SUING CPt. se nti s as ony vcs vee ORs 129 
Turbo POWER TOOLS PLUS/4.0............. 129 
VIEW MANAGER Specify C or Pascal............ 275 
borland products 
EUREKA Equation Solver. z.... 6.0 ows ouewceces 167 
Quattro: The Professional Spreadsheet. ..... . New 195 
Reflex: Tha Analyst ...... ...<<5.0 cu orca eens 150 
BUOOMIOK A>. oe eos aie ns Pete ae ees 85 
NTR. os Siren adds powehke ee eee 100 
Turbo ‘Basic Compiler. ..:.. . 2 605. eee 100 
Turbo Basic Database Toolbox................. 100 
Turbo Basic Editor Toolbox ................... 100 
Turbo Basic Telecom Toolbox.................. 100 
Turbo C Compiler (Ca// for support products) ...... . 100 
Turbo Lightning and Word Wizard .............. 150 
PWNS Light o65 ei 5? a a eee 100 
Turbo Lightning Word Wizard................ 70 
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Turbo Pascal Graphix Toolbox ................. 
Turbo Pascal Numerical Methods Toolbox ........ 
Turbo: Pascal Tutor co Pees Saale 
Turhe Preteg Cemigget o..)2 0. sade nee. 
Tarbes: Crolek Teens; oo visas cia oe lst 


c language 


C-terp by Gimpel, Specify compiler .............- 
C Trainer with Book by Catalytix.............46. 
DCGR 60 CWare soo coe ss ple ee eae New 
DC88 with Large Case Option by C Ware...... New 
Eco-C88 Modeling Compiler by Fcosoft .......... 
Instant C by Rational Systems... .......+22+0+5 
Lattice C Compiler vers. 3.2 from Lattice 
Mark Williams Let's C with FREE csd ............ 
Microsoft C Compiler 5.0 w/CodeView .......... 
Microsoft QuickC Compiler ................... 
Optimum-C by Datalight ...... 2... cece ee eee 
Turbo C Compiler by Borland ..............+.-. 
Turbo C-terp for Turbo C by Gimpel ......... New 
Uniware 68000/10/20 Cross Compiler by SOS .... 


c utilities 
Blackstar C Library by Sterling Castle............ 
CEO Dp Gamannes «Fics. oa inn 0 New Version 
c-tree & r-tree Combo dy FairCom .............. 
c-tree /SAM File Manager ..........0.00000+ 
r-tree Report Generator ............-0.0005 
Curses Window Dev Pkg dy Aspen Scientific ...... 
with. SourCe CODE '> basins. abs SOR Se oe Pees 
dBx dBASE to C Translator by Desktop Al ......... 
Wit SOU LONE FS eset S ou Lee oases vod 
DMS Resident-C by American Software Intl ... New 
Entelekon Combo Package ......... Special Price 
Flash-up by Software Bottling ..............005- 
GraphiC dy Scientific Endeavors ...... New Version 
HALO Graphics by Media Cybernetics ...........- 
HALO Development Pkg for Microsoft............ 
The HAMMER by OFS Systems ..............-. 


Heap 1/0 by System Software ............. New 
HOOPS 3-0 Graphics by Ithaca Software ..... New 
LINK & LOCATE dy Systems & Software...... New 


PANEL dy Roundhill, Specify Quick€ or Turbo C ..... 
PAMEL Pies Dy Rounds. 255 6. bee wes 
PC Lint by Gimpel Software ..............0-44. 
RTC PLUS Fortran to C by Cobalt Blue ........... 
Sapiens V8 Virtual Memory Manager ..........-.- 
Scientific Subroutine Library by Wiley ........... 
TE Developer's Kit by Sub Systems.............. 
Vitamin C by Creative Programming ...........-- 

VC Screen Forms Designer.............0055: 
WKS LIBRARY dy 7enon Software .......... New 
Zview by Data Mgmt Consultants ............... 


cobol language 


COBOL spll dy Flexus 
Micro Focus COBOL See Micro Focus Section 
Microsoft COBOL See Microsoft Section 
Realia COBOL with RealMENU ................ 
Rea COBOL er ee asd Sees. 
Mts, a ne eae a ek ent eds 
RM/COBOL dy Ayan-McFarland ............... 
RM/COBOL 85 by Ayan-McFarland ............. 
RM/USER+5 by Ayan-McFarland............... 
WU DRIGON GS Sieh soe h dae ae ee ee Fs 
SCREENIO: by WOICONN: 6.8 ois Boe asin Sg et os 03 


O08 eS 2Le aS se 0 we OP Ce S66 O'S G8 


database management 


Advanced DBMaster by Macon Software.......... 
Advanced Revelation by COSMOS ........... New 
Comat DY WARNE os Soils Sed sokteeenn New 
DB-FABS hy Computer Control Systems ...... New 
dB2c by Software Connection.............. New 


dBASE Ill Plus by Ashton-Tate ................. 
dbSQL by WordTech Systems .......... 00000 eee 
dBXL by WordTech Systems .............0-005- 
OFLU Dy WQS iiss ooo son oe oie cen ed Bee 
The Documenter by Wallsoft ..............2455 
enable by The Software Group ............. New 
Fox Base Plus by Fox Software............. New 
eo Fe Teer ee eer Er 
MAGIC PC by AKER........... Special Price,New 
Paradox 1.1 by Ansa/Borland................+-. 
Paradox 2.0 by Ansa/Borland................+. 
Paradox Network Pack by Ansa/Borland ......... 
ee ae Pe ae eg ee 
QUICKCODE PLUS dy Fox & Geller ............. 
QUICKINDEX by Fox & Geller ................. 
QUICKREPORT by Fox & Geller ................ 
QuickSilver by WordTech Systems ..........++.- 
R:Base 5000 by Microrim...........-...2+44-. 
R:Base System V by Microrim.................-. 
\rdb by Robinson-Shafer-Wright 
SQL Base by Gupta Technologies ........... New 

Multi-User Verso es he ee New 
Tom Rettig’s Library by 7om Rettig & Assoc ....... 
Ul Programmer by Wallsoft .................-. 
VP-INFO by Paperback Software ............... 


vaca eee eee eS 


VP-PLANNER by Paperback Software ........ New 
VP-PLANNER PLUS hy Paperback Software ... New 
XDB Il by Software Systems Technology ...... New 

C Programming Interface............... New 


debuggers & profilers 
386 DEBUG Cross Debugger by Phar Lap 

Advanced Trace-86 by Morgan Computing 
Codesmith-86 by Visual Age 
DSD87 by Soft Advances 
Me rau: by AWOK .s 35s be aS 
Periscope | with Board by Periscope ............. 
Periscope II with WMI Breakout Switch ........... 
Periscope II-X Software only .................. 


eee eee ee 


ee | 


510 
950 
695 
295 


329 


899 
783 
783 
CALL 
CALL 


379 


105 
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Periscope Ill 8 MHz version ................... 995 
Periscope Ill 10 MHz version ..............4045. 1095 
The PROFILER with Source Code by DWB......... 125 
TURBOsmith Source debugger for Turbo Pascal..... 99 
The WATCHER Profiler by Stony Brook........... 60 
disk utilities 

Back-It by Gazelle Systems ........0.00000 005 130 
Disk Optimizer by Softlogic Systems ............. 60 
Disk Technician by Prime Solutions ............. 100 
FASTBACK by 5th Generation Systems ........... 159 
FASTBACK PLUS dy 5th Generation Systems... New 189 
Take Two Manager United Software Security ...... 139 
Veache hy Golden Bow Systems ................ 50 
Vopt by Golden Bow Systems ...........000005. 50 
Vfeature Deluxe by Go/den Bow Systems ......... 120 
XenoCopy-PC by XenoSoft ...........0 600 ee eee 80 
dos utilities : 
Advanced Norton Utilities..................... 150 
Command Plus by FSP Software ................ 80 
Desqview from Quarterdeck ................... 130 
FANSI-CONSOLE by Hersey Micro .............. 75 
Mace Utilities Pau/ Mace Software .............. 99 
MicroHelp Utility by MicroHelp...............-. 59 
Norton Commander dy Peter Norton ............. 75 
Norton Utilities by Peter Norton ................ 100 
Q-DOS Il by Gazelle Systems ..............4.4.. 70 
Taskview by Sunny Hill Software ...........655. 80 


The Weiner Shell by Gryphon Microproducts ... New 199 
XO-SHELL by Wyte Corporation ............ New 69 


essential products 


Breakout Debugger by Fssential Software ......... 125 
C Ueity GEE 5 oo 20 ees 185 
Essential Communications ...................- 185 
Essential Communications with Break Out ......... 250 
Easentenl Gremhies | «52 eisaind oe ies see Sas 250 
I ERNST oo Spee ade Se bss a Awe Wee Os 99 
with Samra LOGO a pte ea a Oe os 198 
SerdenSie as. c. Sacivic czas Ue. - peep eaeaw 99 
with Library Source Code .............052055 198 
forth language 
FORTH/83 Metacompiler Specify Target ......... 750 
MMS Forth by Miller Microcomputer Svcs... . . New 180 
PC/FORTH by Laboratory Microsystems .......... 150 
PC/FORTH+ dy Laboratory Microsystems ......... 250 
Programmer's Package #1 by/M/ .............. 250 
Programmer's Package #2 by LM/ .............. 350 
Programmer's Package #3 by /M/ .............. 500 
UR/FORTH Also Available for OS/2 by LMI ....... 350 
CH/ FORTH: Like iOS Sos sic tcace Ses oF 8 S 500 
fortran language 
50 MORE: FORTRAN hy Wiley................. 125 
ACS Time Series by Alpha Computer Service ...... 495 
AUTOMATED PROGRAMMER by KGK Automated... 995 
Essential Graphics by Essential Software ......... 250 
Forlib-Plus by A/pha Computer Service ........... 70 
FORTRAN Addenda dy /mpulse Engr............-. 165 
HALO Graphics by Media Cybernetics ..........-. 300 
1/0 PRO w/No Limit Library by MEF ............ 250 
Microcompatibles Combo Package.............. 240 
FO ere ee er a eng fe 135 
OE ee re rman s pny ee 135 
Microsoft FORTRAN w/CodeView .............. 450 
No Limit Library by MEF Environmental........... 129 
Numerical Analyst by MAGUS.................. 295 
PANEL dy Roundhill Computer Systems ........... 295 
RM/FORTRAN dy Ayan-McFarland.............. 595 
Scientific Subroutine Library by Wiley ........... 175 
Statistician by Alpha Computer Service ........... 295 
Strings & Things by Alpha Computer Service ....... 70 
greenleaf products 
Greenleaf C Sampler specify QuickC or Turbo C..... 95 
Greenleaf Comm Library ..................... 185 
Greenleaf Data Windows Library ............... 225 
ME SENEO COED. OS. a are a eae gaa eee 395 
Grommeeh FOMCUONS 5 es oacis ois cine ete oss Rees 185 
help utilities 
ERE OV INOS oes div 5a y Bee ob Bie aye 125 
On-line Help from Opt-Tech ............-.2005. 149 
SoftScreen/HELP dy Dialectic Systems .......... 195 
lattice products 
Lattice C Compiler ver 3.2 from Lattice........... 500 
with Library Source Code ..............2245. 900 
C Cross Reference Generator.................. 50 
C-Food Smorgasbord Function Library............ 150 
with Sainte Cade 0s oho ok Fe ae 300 
C-Sprite Source Level Debugger ................ 175 
Curses Screen Manager ............-.2-2005: 125 
WHY SOUGO COGB HH Fo own ce 05 thw a DIN <6 2.95 Sols 250 
oes a a Fak Sey de A cl Be 250 
Wr SOON CONE doo 28 sy sca ceeeareek 500 
CS So: Se NR Maree irae hese sede 1 memes: 750 
NN NPE LOGS sass oe So RE Seed 1500 
fg Ee | a Ee Py Es 195 
RPG Ii Combo A/ four items below.... New Version 1400 
RPG Il Compiler Vo Royalties... ... New Version 750 
Screen Design Aid Utility for RPG // ... 2... 2... 350 
Sen coutee Entry GURY 66 202 Che Sees 5 250 
DORR UNE os an a doin ne 38 bs nes HEE 250 
SecretDisk Il Encryption Utility. .... 2.2.0.6... 79 
SideTalk Resident Communications .............. 120 
SSP/PC Scientific Subroutine Library ............ 350 
Text Management Utilities .................... 120 
metagraphics products 
geri ont, 1 Ee Pe OES pee Biles Mya 95 
LightWINDOW/C for Datalight€ ............... 95 
MetaWINDOW Wo Aoyalties................... 195 
veemecs ntew ot chaal el: aC 275 
TurboWINDOW/C for Turbo C ................. 95 
TurboWINDOW/ Pascal for Turbo Pascal ......... 95 





CALL 


79 


159 
229 


79 


micro focus products 


Wcte Focus COBOL 2 2 oss aw ls EB 900 
Micro Focus COBOL/2 Toolset ............ New CALL 
Micro Focus COBOL/IO Ad hoc Report Writer ..... 495 
Micro Focus COBOL/IO for DOS 3.X Networks ..... 995 
Micto Fecus FORMS-22. 50/0... ei decides 295 
Micro Focus Level I! COBOL w/Animator......... 495 
LBVOL es Sc Oa Reha = bake oe 349 
Lowel IRNNOONE o2800 ses Sais ws cae’ ba 195 
Micra Fats TUAIGe 6. fl ple ceeded 1495 
WE PNG OOT adie tile sb 6A ersten Ba oa vw 1595 
Micro Focus Personal COBOL ................. 149 
Micro Focus SOURCEWRITER................. 995 
Micro Focus VS COBOL/XENIX ............... 1495 
microport products 
386 Unlimited License Kit .................... 249 
AT Unlimited License Kit ..................... 249 
DOSMerge286 Specify 2-Users or Unlimited....... 149 
DOGRME SOO 2USAIE ois Sees ed cs cew 395 
DOSMerge386 Unlimited Users ................ 495 
System V/386 Combination................... 799 
386 Runtime System ...................... 199 
386 Software Development System ........... 499 
Text Preparation System ................... 199 
System V/AT Combination.................... 549 
At: Runtime System. o.oo  ease 199 
AT Software Development System ............ 249 
Text Preparation System ................... 199 
microsoft products 
Microsoft BASIC Compiler for XEW/IX ............ 695 
Microsoft BASIC Interpreter for XFM/X........... 350 
Microsoft C Compiler 5.0 w/CodeView........... 450 
Microsoft COBOL Compiler with COBOL Tools...... 700 
UM Pa Gh SPS. ck aie he eee boak Secs 995 
DE TNCIES, fi a.5 SOUSA. CE ivy Phe tome kee 495 - 
Microsoft FORTRAN Optimizing Compiler ......... 450 
Microsoft FORTRAN for XEM/X................. 695 
Microsoft Learning DOS ..................... 50 
Microsoft MACH 20 .................... New CALL 
Microsoft Macro Assembler................... 150 
Microsoft Mouse Specify Serial or Bus 
with Paint & Mouse Menus .................. 150 
with Microsoft Windows & Paint .............. 200 
i) IE DE At PE, Ee 175 
Microsoft Pascal Compiler.................... 300 
SP EM Se eats gw she) GOL oh Se whee cae 695 
Microsoft QuickBASIC....................... 99 
PUI A ALR ns Soho aoe bei nnd 08 99 
cht there tal on a; ne a 99 
Microsoft Windows 386.................. New 195 
Microsoft Windows Development Kit ............ 500 
ey ee ee ee ere 450 
Nn EP Gtr in dare vc wee de ve EDs 195 
mks products 
ods. OE ee ee 75 
MKS RCS Aevision Control System.............. 189 
MKS Toolkit with MKS V/ Fditor................ 139 
MKS Trilogy with AWK, CRYPT & Korn Shell. ...... 119 
Mens Wiretor by MKS 2... occ ee dees 75 
modula-2 language 
LOGITECH Modula-2 Development System........ 249 
Modula-2 Compiler Pack ................... 99 
WES RUIE a  k o-w' coke x piey oe ees 169 
LOGITECH Modula-2 Window Pkg.............. 49 
Macro2 Macro preprocessor hy PM/ ............. 89 
cone cee So! bat pee a re re ree 89 
ModGraph by JEQNA .............. 000 e eee 50 
MODULA-2 dy Stony Brook ............... New 195 
Po Sa ee a aaa mes New 345 
MIIINS BPI, osc k a 6 ocd S ie le op adien eae 89 
Science & Engrg Tools by Quinn-Curtis........... 75 
Universal Graphics Library by Quinn-Curtis ........ 130 
mouse products 
LOGIMOUSE BUS with PLUS Pkg by LOGITECH .... 119 
with PLUS & PC Paintbrush. ..............54. 149 
with PLUS & CAD Software................4. 189 
with PLUS & CAD & Paint..............02045. 219 
with PLUS & First Publisher ............0444. CALL 
LOGIMOUSE C7 with PLUS Package ............ 119 
with PLUS & PC Paintbrush. ..........0+0004 149 
with PLUS & CAD Software.............2..4. 189 
me FiUS 6:CAD G Pant...) < vs.0s00e boa e’ 219 
with PLUS & First Publisher ..............4.. CALL 


Microsoft Mouse See Microsoft Section 
novell products 


Btrieve /SAM Mor with No Royalties ............. 245 
a ee er ee Pe 245 
Report Option for Xtrieve ................... 145 

Btrieve/N for Networks .............0-0.0005. 595 
Ee ee ee oe eee ae 595 
Report Option/N for Xtrieve/N............... 345 

WS ee oe are ee wn 6 0 a ler en 9 AO 795 

other languages 

ACTOR by Whitewater Group .... 2... cece eae 495 

CCS MUMPS A// varieties hy MGlohal ...........- CALL 

Marshal Pascal by Marshal Language Systems ..... 189 

Pascal-2 hy Oregon Software ...............4.. 395 

Personal REXX hy Mansfield Software ........... 125 

SHOBOLA+ by Catspaw .. - «2. 6 60 n eee i cee esa 95 

other products 

Carbon Copy Plus by Meridian Technology ........ 195 

Dan Bricklin’s Demo Pgm by Software Garden ..... 75 
Dan Bricklin's Demo Tutorial ................ 50 

Fast Forward by Mark Williams ...............-- 70 

Hi-Screen XL by Softway ..........62.c08. New 149 

Instant Replay Ill by Wostradamus.............-- 150 

MicroTEX /ypesetting from Addison-Wesley ....... 295 
Preater: Biteis s. oick Sees ee CALL 

muMATH by Soft Warehouse ...............+--- 300 

EE ee ee ere Pee eee 149 

Norton Guides Specify Language...............- 100 


OPT-Tech Sort by Opt-Tech Data Proc ........... 149 
Peabody dy Copia Intl, Specify Language ...... New 100 
PC-MOS/386 hy The Software link ......... New 195 
PC/TOOLS Deluxe by Custom Software. .New Version 79 
Resident Expert Specify /ang by Santa Rita ........ 59 
Screen Machine by MicroHelp ................. 79 
screenplay by Flexus, Specify Compiler .......-- CALL 
superSert by LifeStyle . ooo ic koe esac ee 139 
Teamwork/PCSA by Cadre Technologies ..... New 995 


The SLATE System by The Symmetry Group ... New 299 
phoenix products 


C/Pac Combination of PforCe and Pre-C ...... New 495 
Pasm86 Macro Assembler version2.0............ 195 
Pdisk Hard Disk & Backup Utility................ 145 
Pfantasy Pac Phoenix Combo .................. 995 
Pfinish Fxecution Profiler ....................-. 395 
Pfix8Gplus Symbolic Debugger ................. 395 
PforCe Specify C Compiler .............0..044. 395 
PforCe++ Specify C Compiler and C++ ........... 395 
Plink8Gplus Overlay Linker .............0..005. 495 
amas Meene UNA ee ee ee 125 
Pmate Macro Text Fditor ............0000 0005. 195 
POE DUMMIES. Ue 6 ice Oe Cha ela Suu ah i 295 
polytron products 
PolyBoost Il Software Accelerator......... Special 80 
I Uo so oly Ee inna Vika tlee s 99 
CUMNONON ATCINWEN 2 Peo ice coca xn tes 50 
PolyDesk Cryptographer.................... 50 
Cot pate oe Bee ene 50 
PolyLibrarian Library Manager ................. 99 
PolyLibrarian Il Library Manager................ 149 
PolyMake UM/X-like Make Facility............... 149 
PolyShell......... tah PR ahi we Special Price 149 
Perea DOGMINE So os os cash ve co cee} 50 
PolyXREF Complete Cross Ref Utility ............ 219 
PolyXREF One /anguage only .................. 129 
PVCS Corporate Version Control System.......... 395 
ie i i On ee 149 
program mgmt utilities 
Interactive EASYFLOW dy Haventree ............ 150 
Print by Software Directions.................. 89 
Quilt Computing Combo QMake & SRMS.......... 250 
ONE hie ce a5 cw icles Bl ceiba ee inne 179 
Sapiens MAKE & V8 ........................ 439 
Source Print by A/deharan labs ................ 97 
TLIB Version Control System by Burton ........... 100 
Tree Diagrammer hy A/debaran Labs ............ 77 
sco products 
Complete XENIX System V dy SCO.............. 1295 
Development System ...................... 595 
Operating System Specify XT or AT............ 595 
Text Processing Package................... 195 
BS Es Bt See a ees ee 595 
SCO Professional 7-2-3 Workalike for XENIX....... 795 
Seid ce i, | a ee aA 595 
XENIX System V 386 by SCO.................. CALL 
text editors 
Brief & dBrief Combo from Solution Systems ...... 275 
i ER Te ee, Sey PR, Pe eae 195 
dBrief Customizes Brief for dBASE Iil........... 95 
Epsilon Emacs-like editor hy Lugaru.............. 195 
KEDIT by Mansfield Software .................. 125 
Micro/SPF by PHASER SYSTEMS .............. 175 
coiaror adh ao, Ee Sale, eee ee 450 
PC/VI by Custom Software Systems ............. 149 
SPF/PC by Command Technology Corp........... CALL 
Vedit Plus by CompuView..................00. 185 
turbo pascal utilities 
ALICE /nterpreter by Looking Glass Software ....... 95 
AZATAR DOS Toolkit by AZATAR............... 95 
DOS/BIOS & Mouse Tools by Quinn-Curtis........ 75 
Flash-up by Software Bottling...............4.. 89 
Flash-up Developer's Toolbox.................. 49 
MACH 2 for Turbo Pascal by MicroHelp .......... 69 
MetraByte D/A Tools by Quinn-Curtis............ 100 
Science & Engrg Tools by Quinn-Curtis........... 75 
Screen Sculptor by Software Bottling ............ 125 
Speed Screen by Software Bottling.............. 35 
System Builder by Royal American .............. 150 
PER Cy CEM... sin ak ale Wow ane 100 
ne te ET CeO Peer ee 130 
TDebugPLUS dy 7urboPower Software ........... 60 
Tmark by Tangent Designs ...............044.. 80 
Turbo Professional 4.0 from TurhoPower... New Vrs 99 
FerpetiAD Wem My 265. S55 ew obs vee see's 95 
TurboPower Utilities by TurboPower............. 95 
TurboRef by Gracon Services ...............4-. 50 
TURBOsmith Source Debugger by Visual Age ...... 99 
Universal Graphics Library by Quinn-Curtis ........ 130 
wendin products 
Operating System Toolbox .................... 99 
PCNX Operating system .............00 eee eee 99 
PCVMS Similar to VAX/VMS .... 2.0.06. 0 ee eee 99 
Wendin-DOS Multitasking DOS................. 99 
Wendin-DOS Application Developer's Kit ......... 99 
XTC Jext Editor w/Pascal source ............... 99 
xenix/ unix products 
Btrieve /SAM File Mgr by Novell ................ 595 
Ce Oe CN, 8 is ok ots Aawewnde 498 
c-tree [SAM Mor by FairCom ................4.. 395 
dBx with Library Source by Desktop Al............ 550 
DIRECTORY SHELL 286 by American Mgmt Sys.... 349 
DIRECTORY SHELL 386 by American Mgmt Sys.... 495 
Epsilon 7ext Foitor by Lugaru .................. 195 
PANEL Plus by Roundhill Computer Systems ...... . 795 
REAL-TOOLS Binary Version by PCT ............- 99 
Complete Source Version ............0++0055 999 
RM/COBOL dy Ayan-McFarland ................ 1250 
RM/FORTRAN by Ayan-McFarland.............. 750 


Terms are subject to change. 
©1987 Programmers Connection, Inc. 
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LOWEST PRICES 
Due to printing lead times, some of our current 
prices may differ from those shown here. Call for 
latest pricing. 


FREE SHIPPING 
Orders within the USA (including Alaska & Hawaii) 
are shipped FREE via UPS. Express shipping is 
available at the shipping carrier's standard rate 
with no rush fees or handling charges. To avoid 
delays when ordering by mail, please call first to 
determine the exact cost of express shipping. 


CREDIT CARDS 
VISA and MasterCard are accepted at no extra 
cost. Your card is charged when your order is 
shipped. Mail orders please include credit card 
expiration date and authorized signature. 

CODs AND POs 
CODs and Purchase Orders are accepted at no 
extra cost. No personal checks are accepted on 
COD orders. POs with net 30-day terms (with initial 
minimum order of $100) are available to qualified 
US accounts only. 


SALES TAX 


Orders outside of Ohio are not charged state sales 
tax. Ohio customers please add 5% Ohio tax or 
provide proof of tax-exemption. 
INTERNATIONAL ORDERS 
Shipping charges for International and Canadian 
orders are based on the shipping carrier's standard 
rate. Since rates vary between carriers, please call 
or write for the exact cost. International orders 
(except Canada), please include an additional $10 
for export preparation. All payments must be made 
with US funds drawn on a US bank. Please include 
your telephone number when ordering by mail. Due 
to government regulations, we cannot ship to all 
countries. 
VOLUME ORDERS 
Volume orders may qualify for additional discounts. 
Call us for special pricing. 
SOUND ADVICE 
Our knowledgeable technical staff can answer 
technical questions, assist in comparing products 
and send you detailed product information tailored 
to your needs. 
30-DAY GUARANTEE 
Most of our products (excluding books) come with 
a 30-day documentation evaluation period or a 
30-day return guarantee. Please note that some 
manufacturers restrict us from offering guarantees 
on their products. Call for more information. 


MAIL ORDERS 


- Please include your telephone number on all mail 


orders. Be sure to specify computer, operating 


~ system and any applicable compiler or hardware 


interface(s). Send mail orders to: 
Programmer’s Connection 
7249 Whipple Ave. NW 
North Canton, OH 44720 


NIN etree ye icc 800-336-1166 
CANADA... 800-225-1166 
OHIO & ALASKA (Collect) 216-494-3781 
[2 | > SRS neees tesa Pages| 9102406879 
EASYLINK 62806530 
INTERNATIONAL 216-494-3781 


CUSTOMER SERVICE .. 216-494-8899 
Hours: Weekdays 8:30 AM to 8:00 PM EST. 
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rue magazines really do have 

something like personality. You 
can develop a relationship with 
them. That’s why it seems so unfair 
when a publisher repositions an old 
friend, as McGraw-Hill is doing with 
Byte. It’s all the more annoying 
when the change seems so patently 
unnecessary. Isn't it obvious that we 
need a Scientific American of com- 
puter technology more than we 
need another PC magazine? Not to 
McGraw-Hill it isn't. 

McGraw-Hill is not alone in opting 
for the product-catalog approach; 
the trend is depressingly wide- 
spread. Even our new section of 
short reviews, Examining Room (de- 
buting in this issue), could be seen 
as symptomatic of the trend. But 
DDJ is, | assure you, in no danger of 
becoming a product catalog. It 
wouldn't fit with the personality. 


Speaking of personality, the Peter 
Norton T-shirt came in the mail re- 
cently, close on the heels of the 
Peter _Norton- poster, the Feter 
Norton Christmas card, and _ the 
Peter Norton coffee cup. (If you 
didn't like the coffee cup, Peter 
Norton would send you a Peter 
Norton hammer to smash it with.) 

Now I believe that the Norton Utili- 
ties are nifty, and that Peter has as 
much right as anybody to throw his 
hat in the ring for Mr. Cultural Icon 
of 1988, but all this fuss over a com- 
pany that produces programs for 
wiping files and cleaning up directo- 
ries gives me pause. Norton is, after 
all, in the utility business, a sort of 
electronic Tidy Bowl man, the digi- 
tal descendant of Ed Norton. Is this 
an image you want to display on 
your coffee table? Consider well 
when marking your ballot. 


Another clean-cut kid, Rob Dicker- 
son, has been making news lately, 
in the sections of what newspaper 


SWAINE'S FLAMES 





business pages call Transitions. 
Some of you know Dickerson from 
Microsoft's language division. In De- 
cember he became Borland’s latest 
acquisition, with the new title of 
vice president, product marketing. 
Microsoft responded to Dickerson’s 
career move with a lawsuit and a 
restraining order, and Borland coun- 
tersued. By the time you read this 
the suits should be settled, or at 
least moot. 

Microsoft had reason to be upset; 
Dickerson knows a lot that could be 
useful to the competition, and that 
means Borland. (I am _ specifically 
not referring to his knowledge of 
Microsoft strategies. I have no knowl- 
edge regarding Rob's knowledge 
about Microsoft strategies, thank 
you, Microsoft lawyers. What I have 
is informed opinion.) Meanwhile, 
Borland is building new quarters in 
Scotts Valley to accommodate its 
growth. I think it is going to call the 
new space the Borland campus. 


I spent many pages in this maga- 
zine last year Campaigning for arti- 
cles on how to break various band- 
width bottlenecks. Bandwidth is, un- 
fortunately, becoming a vogue word. 
You can find it in John Sculley’s 
Odyssey: From Pepsi to Apple, where 
Sculley applies it to marketing. He 
probably picked up this usage from 
Steve Jobs, a good man with a meta- 
phor. 

You can find the term used more 
precisely and with more purpose in 
The Media Lab by Stewart Brand, a 
good book on current research at 
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MIT into the convergent technolo- 
gies of publishing, computing, and 
broadcasting. The principals in The 
Media Lab believe that bandwidth 
reduction is the issue of the decade, 
and they are acting on that belief. I 
recommend Brand’s book. (I haven't 
been inspired to read Sculley’s yet.) 


I sometimes think that Marlin Ou- 
verson, a former DDJ editor, timed 
his leaving so that he could title his 
farewell editorial, in paraphrase of 
Richard Henry Dana, “Two Years 
Before the Masthead.” 

Which leads me to the following. 

I became editor-in-chief of Dr. 
Dobb's Journal in 1984 and have 
now spent more years at the helm 
than any other editor (including 
Marlin Ouverson). While I am fond 
of this magazine and think it serves 
a need that the product-catalog maga- 
zines don't, four years is a long 
time—a third of the life of the maga- 
zine, a tenth of my own life, longer 
than Sculley has been at Apple (or 
about as long as there has been a 
Macintosh product line)—and these 
four years have been four years away 
from full-time writing on the rock 
pile of a largely administrative job. 

For a writer, that’s a long sen- 
tence. 

So, over the next few months, I 
will be creating a new role for myself 
with the magazine, one that will 
allow me to do more writing. I plan 
to research and write about topics 
close to my interests and, according 
to our reader survey and to my in- 
formal survey in the November 
issue, close to yours as well. 

More about that next month. 


Hl. dara Sarerng 


Michael Swaine 
editor-in-chief 


Dr. Dobb's Journal, February 1988 
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Some Of The Most Ranous Faces 
In Software Use Our C Functions 


Our famous customers are a little camera shy. It’s not that 
they are embarrassed by being Essential C Utility Library 
users. They just don’t want us shouting their names from 





Functions At A Glance 


¢ Fastest screen output available. © Disk error trapping 





the roof tops. e Save/Restore color screens in e Determine space available 
1/10 sec. e 40 functions to process 
e Pop-up block cursor menus characters and words 
The prestige of our users is not the primary reason to buy e Save/Restore windows to disk —@ Insert, delete, extract, index, 
the Essential C Utility Library. The increased speed, or memory translate 
features, and size efficiency of our products are the factors ¢ 50 functions for business Tested, easy-to-follow examples 
that demand their use. Our library contains over 400 graphics ee Eee Se ty 
; © dozens of string formats code 
f wbelaabe all © time and date arithmetic e All source code included 
designed with » julian and day-of-week Documentation: 
elegance in mind. @ Ctrl-Break key trapping Thorough, comprehensive, 260 
e Field oriented data entry pages 

However should e Stuff keyboard buffer . Compatible C Compilers: 

beta e 18 Mouse control functions Microsoft, Lattice, Computer 
curiosity get the e Execute programs and batch Innovations, Aztec, Mark 
best of you, call us files Williams, DeSmet, and Wizard 
at 201-762-6965 L y 
and we'll drop $185.00 


a few highly Do Your Homework 
PEs ve Haalies The library you buy can influence the rest of your 
on you. 


programming life. We encourage you to do some checking 
before making a decision. When you’ve done your home- 
work, you'll choose Essential. Call our support staff of 
experienced C programmers and find out before you buy 
how things will be after your check clears. 





Behind every great program is a great 
library, 


What’s a Library Without a Librarian? 


Our library comes complete with a sophisticated source 
code librarian. Now you can maintain current versions and 
conserve disk space. We want your development work to 
go as smoothly as possible. 


To order or for support 
call: 201-762-6965 


For foreign orders contact: 
England: Gray Matter Tel. (0364) 53499 
Japan: Lifeboat Inc. of Japan Tel: 293 4711 
West Germany: Omnitex Tel. 07623-61820 





No Royalties, 30 Day Guarantee 


If within 30 days you don’t find our library totally 
satisfactory, bag the whole thing and receive a complete 
refund. There are no royalties associated with the 
library. 


Essential Software,- Inc. 
PO. Box 1003, Maplewood, New Jersey 07040 
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Whatever dialect of IBM you need to speak, 
CROSSTALK® Mk. 4 makes the connection. 


Now, one program does the job that used to require several. 
CROSSTALK® Mk. 4 allows high-speed direct communications 
between PCs and minicomputers, or (with an IRMA™ board) 

between your PC and an IBM Mainframe, or (with Smart Alec™) 
between your PC and IBM System 3x’s. If you like, CROSSTALK 
can support all of these sessions (and others) simultaneously, 
and display each session in its own window. 
CROSSTALK Mk. 4 emulates all the terminals you’re likely 
to find useful. That includes IBM 3101 (page and character 
modes), IBM 525x, IBM 529x, IBM 327x, as well as many 
popular async terminals like the DEC VT100 and VT220 
series. CROSSTALK Mk. 4 includes the powerful CASL™ 
programming language, which allows you to automate 
communications applications quickly and easily. 
So if you're used to thinking of CROSSTALK just to 
use with a modem, you’re missing some important 
connections. Ask your dealer for details, or write: 


eee Digital Communications Associates, Inc. 
1000 Holcomb Woods Parkway / Roswell, Georgia 30076 
1-800-241-6393 


CROCTALK’ 


COMMUNICATIONS 
Wy 


CROSSTALK and DCA are registered trademarks of Digital Communications 

Associates, Inc. IRMA, Smart Alec and CASL are trademarks of Digital Communi- 
cations Associates, Inc. IBM is a registered trademark of International Business 
Machines Corp. DEC is a registered trademark of Digital Equipment Corp. 
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